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INTRODUCTION 

The HP 98645A Measurement Library provides a set of easy-to-use subroutines for taking readings from 
the HP 98640A Analog -to -Digital Converter (ADC) card. These subroutines can be used from the BASIC 
or Pascal language systems on HP 9000 Series 200 or Series 300 computers. The subroutines are written 
in Pascal, and are adapted to the BASIC language with the CSUB utility package. The Measurement 
Library is compatible with BASIC 2. 0, 2. 1, 3. 0, 4.0, 5.0, 5. 1, and Pascal 2. 0, 2. 1, 3.0, 3. 1, 3. 2. 

The Measurement Library subroutine calls are a superset of the "HP 14751 A Computer Aided Test 
Programming Package for the Model 6944A". BASIC programs written using the HP 14751 A routines 
should be able to use the Measurement Library software with very little modification. 



Features 

The HP 98645A Measurement Library allows you to: 

Take a single reading from any of 8 channels at any of 4 gains. 

Take readings by scanning across 1 to 8 channels, any number of times. 

Take readings from channels in random order as specified in an address array. Optionally, you can 
specify the gain and pace interval for each reading, and the readings can be repeated any number of 
times. 

Express readings in three different units: 
Base units: binary integer returned from the ADC. 

Standard units: base units adjusted for gain and calibration, expressed as real numbers. 
User unite standard units times a user multiplier plus a user offset 

Take calibration (zero) readings on a specified channel, and apply that calibration adjustment to all 
readings. 

Re-set gain or units at any time. 

Take readings at the full 55 kHz sampling speed of the ADC card from either BASIC or Pascal 

Take readings under interrupt mode in BASIC. 
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Software Provided 

The HP 98645A Measurement Library includes these subroutine packages: 
MEAS__LIB for use with BASIC 2. 
MEAS_LIB3 for use with BASIC 3. 
MEAS_LIB4 for use with BASIC 4.0 
MEAS_LIB5 for use with BASIC 5. 

MEASLIB42 for use with BASIC 4. on a Model 320 computer 
MEASLIB52 for use with BASIC 5. or 5. 1 on a Model 320 computer 
INTR2__1 for use with interrupt mode in BASIC 2. 1 
MEAS_LIB.CODE for use with Pascal 2. 0/2. 1 
MEAS__LIB3.CODE for use with Pascal 3. 0/3. 1/3. 2 

MEASLIB32.CODE for use with Pascal 3. 1/3. 2 on a Model 320 computer. 

The software is provided on the following media: 
Option #630: 3-1/2" floppy disc 
Option #655: 5- 1/4" floppy disc 

MEAS__LIB and MEAS_JLIB.CODE will not use floating point hardware. MEAS__LE83, MEAS_LIB4, 
MEAS__LIB5, and MEAS_LIB3.CODE will use a Floating Point Math card if it is installed in the system; 
otherwise they will use the Pascal floating point library routines. MEASLIB42, MEASLIBS2, and 
MEASLIB32.CODE will use the built-in floating point hardware in the Model 320 computer; these 
routines are not compatible with any other processor. 



THE GENERAL APPROACH 

The way you write programs using the Measurement Library is pretty much the same whether you use the 
BASIC or Pascal language system. There are, however, significant differences in the way you set up youi 
system environment. We will discuss these differences in the next few paragraphs. 

Using BASIC 2.1 

If you are using the BASIC 2. 1 system, take the following steps to get your application up and running: 

1) Boot up BASIC 10. 

%) Load the BASIC 2. 1 extensions. The 2. 1 extensions are located on the Extended BASIC 2. 1 disc 
Insert that disc into the master drive and issue the command LOAD BIN "AP2 1". 

3) Load the interrupt processing package if you will be taking readings in interrupt mode. (Interrup 

mode readings are discussed later in this section.) The interrupt processing package is located on th< 
Measurement Library disc. Insert that disc into the master drive and issue the command LOAI 
BIN M INTR2_J". 

4) Load any other BASIC extensions that you need for your application. For example, this would b 

the time to load Graphics 2. 1. 

5) Write your BASIC program or load a previously written program into memory. In the paragraph 

below we will describe how to write your application program using the Measurement Library. 
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6) Load the Measurement Library subroutines if they are not already part of the program you wrote 

in the pr, Wous step. The subroutines are located on the Measurement Library disc. Insert that disc 
into the master drive and issue the command LOADSUB ALL FROM M MEAS_LIB". 

7) Run your program. Debug as necessary (repeating steps 5 through 7). 

Using BASIC 3.0, 4.0, 5.0, or 5.1 

If you are using the BASIC 3. 0, BASIC 4. 0, BASIC 5. 0, or BASIC 5. 1 system, take the following steps to 
get your application up and running: 

1) Boot up BASIC 3. 0, 4.0, 5. 0, or 5. 1. 

2) Load the BASIC 3. 0, 4. 0, 5. 0, or 5. 1 IO binary if you will be taking readings in interrupt mode. 

(Interrupt mode readings are discussed later in this section.) The IO binary is located on the BASIC 
Language Binary disc. Insert that disc into the master drive and issue the command LOAD BIN 
"10°. 

3) Load any other BASIC binaries that you need for your application. For example, this would be the 

time to load graphics routines. 

4) Write your BASIC program or load a previously written program into memory. In the paragraphs 

below we will describe how to write your application program using the Measurement Library. 

5) Load the Measurement Library subroutines if they are not already part of the program you wrote 

in the previous step. The subroutines are located on the Measurement Library disc. Insert that disc 
into the master drive and issue the command: 

LOADSUB ALL FROM "MEASJ.IB3" or 

LOADSUB ALL FROM "MEASJ.IB4" or 

LOADSUB ALL FROM M MEAS_LIB5" or 

LOADSUB ALL FROM "MEASLIB42" or 
LOADSUB ALL FROM n MEASLIB52 M 

as appropriate for your system. (Refer to the paragraphs on "Software Provided", above, for 
information on which software goes with which system.) 

6) Run your program. Debug as necessary (repeating steps 4 through 6). 

General BASIC Programming 

The Measurement Library subroutines add approximately 23,700 bytes to your BASIC program. The 
INTR2 1 binary adds approximately 1200 bytes. 

Note that integer parameters used in the Measurement Library subroutine calls must be explicitly typed as 
INTEGER. (You can find out which parameters are integers by looking at the parameter descriptions in 
the subroutine call listings in Section 2 of this manual. ) Real parameters and string parameters (those 
ending in $) need not be explicitly typed. Literal constants of any type (integer, real, or string) may be 
used. Note that integers must not contain a decimal point. 

You can invoke Measurement Library routines by calling them (CALL statement) or simply by entering 
them by name. When you use them in an IF . . THEN statement or an ON . . statement, the "CALL N 
must be explicit. 
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Using Pascal 2.0, 2.1, 3.0, 3.1, or 3.2 

You can call the Measurement Library subroutines from the Pascal language by importing the 
Measurement Library and using the library subroutines as procedure calls with the syntax described in 
Section 2 of this manual Typically, you import the Measurement Library with a compiler directive of 

$SEARCH 'MEAS LIB'$ or 
$SEARCH 'MEAS~LIB3'$ or 
$SEARCH 'MEASLIB32'$ 

and an import statement of 

IMPORT measurement^ ib; 
in your code. Importing the Measurement Library adds about 17600 bytes to your Pascal program. 

If the Pascal system modules INTERFACE and IO have not been merged into the system library file, you 
will also have to include the compiler directive 

$SEARCH 'INTERFACE. ', '10. '$ 

Note that the ". " after each file name is significant. 

The procedure calls for the Measurement Library are all exported from the file MEAS LIB. CODE (or 

MEAS_LIB3.CODE), along with the following types: 

TYPE shortint « -32768. .32767; 
byte « 0. .255; 
Btr255 * atring[255] ; 

iar ray type ■ ARRAY [0. .maxint] OF shortint; 
rarraytype * ARRAY [0. .maxint] OF real; 
rarraypt-= "rarraytype; 
iarraypt ■ "iarraytype; 

Due to the rigorous structure of the Pascal language, you can't default parameters in the procedure calls. 
However, to save you the bother of declaring real and integer arrays for the pace and gain array 
parameters of the random__scan procedure, you can use the default pace or gain value (established by a 
call to Config_0 or Set__gain) by specifying a for the array size and a NIL for the array pointer. All 
other parameters for all procedure calls must be explicitly provided in the procedure call as real, integer 
(or shortint), or string variables, or as constants or literal constants. For all array parameters, make sure 
that the array elements are of the correct type, real or shortint; do not substitute integer for shortint. 
And take care that the size parameter you pass for an array does not exceed the actual size you declared 
for that array. (If you exceed the declared array size, you can write all over the other variables in your 
program, and cause yourself much anguish. ) 

Once your Pascal program has been written and compiled, it must be merged or linked to the 
Measurement Library using the Pascal system librarian program. Be sure to transfer ALL the modules in 

MEAS LIB or MEAS_LIB3. If IO is not in your system library file you will also have to transfer the 

module IOCOMASM from the file IO (found on your LIB: disc). 

Interrupt mode operation is not supported in the Pascal environment. (That means we don't guarantee 
that it will work. If you try it and it doesn't work, you can purchase consulting services from the nearest 
HP sales and service office. See the back section of this manual for a list of sales and service offices. ) An 
interrupt service routine (ISR) is required for interrupt mode to work in Pascal, and we do not provide a 
Pascal ISR with the Measurement Library. If you try to use interrupt mode in Pascal without a proper 
ISR, you will probably crash your system. If you're an experienced Pascal programmer, you may be able to 
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write you* own ISR. For more information on ISRs, refer to the Pascal 2. System Designer's Guide, part 
number 09826-90074. 



WRITING THE PROGRAM 

In both BASIC and Pascal, writing your application program involves two major activities: setting up the 
card to take readings, and taking the readings. In addition, BASIC programs may take readings in 
interrupt mode. We will cover these subjects in the paragraphs that follow. We will also say a few words 
about externally paced readings. 

All of the subroutine calls referred to below are described in detail in Section 2 of this manual. 

Setting Up 

Setting up an ADC card for readings requires allocation of a common area, as well as calls to at least three 
subroutines: Meas lib init, Config 0, and Init. 

The common area serves as the heap space for the subroutines in the Measurement Library. It is allocated 
automatically in Pascal; in BASIC you must allocate it explicitly at the beginning of your program. 
Reserve this area by including the following statement in your program: 

20 COM/Heapcom/ INTEGER Heaparea(1 :n) 

where n is the size of the Heaparea array. The size of Heaparea is determined by the number of 
configured names for ADC cards (more about that later) and the number of readings taken for calibration 
(ditto). Use S3 integers for each ADC card configuration and 4 integers for each reading used in 
calibration. We recommend using Heaparea(l:l 300); this allows all 16 possible ADC card configurations 
and a calibration run of 1 00 readings. 

In both BASIC and Pascal, the subroutine calls to Meas lib init, Config 0, and Init do the following: 

Meas lib init initializes the Measurement Library, and must be called before any other subroutines in 

the library are called. Meas lib init needs to be called only once in your program. 

Config sets up an ADC card for taking readings. At a minimum, you specify a name by which you 

will call the card and the model number of the card. In addition, you can specify the select code of the 
card, its gain, a pace rate for taking readings, an error reporting parameter for normal mode overrange 
errors, and the units (base, standard, or user) in which the readings will be reported. (Reporting units 
are discussed below.) If you do not supply these optional parameters, Config__0 will supply default 
values. 

Init resets an individual card, disables interrupts for that card, and sets the calibration array for that 

card to its default values. Init must be used before any other calls except Meas lib init, Config 

and System init. System init is the same as Init, except that it initializes all cards that have been 

configured. 
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The set-up portion of a typical BASIC program might look like this: 



20 COM/Heapcom/ INTEGER Heaparea(1 : 1300) 

30 INTEGER Select code, Gain 

40 Name$="ADC" 

50 Model$= n 98640A" 

60 Select_code=18 

70 Gain=1 

80 Pace*0.01 

90 Error$= M No" 

100 Unit$="Standard" 



220 Meas_lib_init 

230 ConfTg olName$,Model$, Select code, Gain, Pace, Error$,Unit$) 

240 Init(Name$) 



The analogous Pascal code would look like this: 



CONST name * 'ADC'; 

model = '98640A'; 
aelect_code « 18; 
gain «"1 ; 
pace ■ 0.01 ; 
error * 'NO'; 
unita ■ 'STANDARD'; 
multiplier « 1.0; 
offset =0.0; 



BEGIN 



meas_lib in it; 

config__oXname, model, select_code, gain, pace, error, unit 8, multiplier, of fset) ; 

init(name); 



The most frequently used configuration parameters can be reset without reconfiguring the card; these 

parameters are gain, pace interval, and units. The gain can be reset with a call to the Set gain 

subroutine, or a new gain can be specified as a parameter to the Input or Random scan subroutine. (The 

Input and Random scan subroutines are used to take voltage readings from the ADC; they are described 

later in this section.) A new pacing interval can be specified as a parameter to the Input, 

Sequential scan, or Random_scan subroutine. And the units can be reset with a call to the Set__units 

subroutine. (Note that if you specify pace or gain parameters in an Input, Sequential scan, or 

Random scan call, the specified pace or gain value holds only for the duration of the call; it reverts to its 

previous value after the call completes. ) 
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Calibration 



Calibration gives you a way of compensating for offsets that are inherent to the ADC card. To use the 
calibration feature, you must first reserve one of the channels on the card and short the + Input and 
- Input terminals on that channel to card ground. Then use the Calibrate subroutine to take a specified 
number of readings from that channel at a specified pace rate. The readings are taken at each of the gain 
settings and the average at each gain is saved. These average readings are then used to calculate 
correction values for positive and negative readings at each gain setting. When a subsequent reading is 
taken pn any of the other channels, the appropriate correction value is subtracted from the raw reading 
before conversion to standard or user units. 

Reporting Units 

Reporting units come in three flavors: base, standard, and user; you specify one of these with the 
Config or Set units command. The units are: 

Base units. Base units are in the form of a 1 6 -bit binary integer, of which twelve bits represent the 
magnitude of the reading. Readings reported in base units are raw readings; gain factors and 
calibration corrections are not applied to base units. The format of a base unit reading is: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 
+ + + + + + + + + + + + + + + + + 

|B|W|0|S|D|D|D|D|D|D|D|D|D|D|D|D| 
+ + + + +---+ + + + + + + + + + + + 

where: 

B ■ BUSY. If bit 1 5 * I, the ADC is busy. The reading is not taken and all other bits are invalid. If bit 
1 5 ■ 0, a valid reading is returned. 

W ■« WAIT. If bit 14 « 1, the ADC card was in the wait state at the time of the reading. This means 
that the card was not read within the interval specified in the pacing timer — that is, a paced read 
was not made at the correct time. (Generally you will not see this bit set, since the ADC Library 
software reports an incorrectly paced read as an error and will not return a value for the reading. ) 

O ■ OVERRANGE If bit 1 3 » 0, a common mode overrange condition occurred during this reading, 
and the reading is invalid. (Common mode overrange errors are discussed later in this section. ) If bit 
1 3 - 1, no common mode overrange condition occurred during this reading. Note that the sense of 
this bit is negative true. 

S * SIGN. If bit 12 ■ 0, the value returned for the reading is positive. If bit 12 - 1, the value returned 
for the reading is negative. 

D • DATA. The data bits give the 1 2 -bit binary magnitude of the voltage read from the ADC. (The 
sign of the voltage is given by the S bit, bit 12.) 

Note that all readings taken from the ADC card by the ADC Library software are returned to your 
program through real number parameters. This includes readings in base units. Thus, while the base 
unit readings have integer values, they look like real numbers to your program until you explicitly 
convert them to integers. Assigning them to integer variables in BASIC, or using the trunc or round 
function in Pascal, will make the conversion. 
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Standard units. Standard units are base units adjusted for gain and calibration, expressed as rea 
numbers. They are, in other words, volts. 

User units. User units are standard units to which a user-specified multiplier and offset have beer 

applied, expressed as real numbers. You specify the values for the multiplier and offset in a Conf ig ( 

or Set units subroutine call. (The default values for multiplier and offset yield standard unit values. 

You might use user units to change the units of your readings or to compensate for a known offset ir 
your readings, or both. 

For example, say you were taking readings from a 4 -to- 20 mA current loop transmitter connected to a 
flow meter. Say further that the range of the flow meter was from to 50 gallons per minute, and 
that you were making your voltage readings across a 250-ohm resistor. That would mean that a 
reading of 1.0 volts corresponded to a flow rate of gpm and that 5. volts corresponded to 50 gpm. 
Using y-mx+b, you can derive a multiplier of 12.5 and an offset of -12.5, and specify these a! 
parameters to a Config call. 



180 Config - 0( M Flow ,, ,"98640A M ,18,1,.01, , 'No ,, , ,, Uaer ,, ,12.5,-12.5) 



Then, whenever you take a reading from that current loop, the result is expressed directly in gallons per 
minute. That's a lot easier than making a conversion from standard units every time you take a voltage 
reading. 

Error Reporting and Handling 

The Measurement Library reports errors for a variety of reasons. Typical errors include configuration 
errors, pacing errors, and overrange errors. When such an error occurs, the Measurement Library forces a 
system error and returns the error number. Your application program can trap and handle these errors 
using the ON ERROR mechanism (in BASIC) or the Try-Recover mechanism (in Pascal). In BASIC, you 
can get the error number with the ERRN function; in Pascal, use the ESCAPECODE function. (Certain 
run time errors may be reported in BASIC as the Pascal error number plus 400. These errors are listed in 
Appendix A.) If the errors are not trapped, your program will abort and the system will report the error. 

The errors that can be returned by the Measurement Library are listed in Appendix A. 

Note that one of the parameters of the Config__0 subroutine determines whether normal overranges are 
reported as errors or not Note also that if you are using base units, no overrange errors — either normal 
or common mode — are reported. (You can detect overrange conditions from the bits returned in base 
unit format. ) Overrange errors and pacing errors are discussed in more detail later in this chapter. 

Multiple Configurations 

The Measurement Library allows you to have up to 16 different ADC card configurations at any one 

time. Each configuration requires a separate call to Config 0, and each call specifies a unique name for 

a card. You can assign multiple names, and thus multiple configurations, to a single card if you wish. 
This would allow you to take readings from different voltage sources on different channels of the same 
card without reconfiguring the card all the time. For example, say you had flow meters connected to 
channels 1, 2, and 3 of the card and thermocouples connected to channels 4, 5, 6, and 7. You could 
specify one name for a flow meter configuration and another name for a thermocouple configuration: 
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180 ConfigJ)( M Flow M ,"98640A",18,1,.01,"No","User",12.5,-12.5) 
190 Conf igJ)("Thermo","98640A ,, ,18,64,. 01 ,"No", "Standard") 



When you want to take a reading from cither type of voltage source, just specify the name of the 
appropriate configuration in your reading call: 



420 Input ("Thermo", 5,Tvolt) 
430 Input ("Flow", 2, Cpm) 



If 16 different ADC configurations are not enough for your application, you can get more by re-using 

existing names. Do this by making a call to Config and specifying an existing name; the old 

configuration parameters for that name will be erased and the new parameters (or their default values) 
will replace them. You will then have to re -initialize the name with a call to the Init subroutine before 
you can use the new configuration. 

Note that the use of different names for the same ADC card will not work in interrupt mode. DO NOT 
ATTEMPT TO ACCESS AN ADC BY A DIFFERENT NAME DURING INTERRUPT MODE DATA 
TRANSFERS. 

Taking Readings 

Taking readings is the whole reason for having an ADC card. Now that you've got your system 
configured, it's time to start taking those readings. All readings from the ADC card are taken by three 
subroutines: Input/Read channel, Sequential scan, and Random scan. Here's how you use them: 

Input /read channel. Use the Input or Read channel subroutine for taking a single reading from a 

channel on the ADC card. Optionally, you can specify a gain and a pace interval in the subroutine call. 

A call to Input would look like this in BASIC: 

340 Input ("ADC", Chan, Volts) 
The analogous call to Read channel would look like this in Pascal: 

read_channel( 'ADC ',chan, volts, gain, pace) ; 

Input is the name of the routine as used in a BASIC program; in a Pascal program, use Read channel. 

Input was chosen for BASIC for compatibility with the HP 14751 A software. Note that you must be 
very specific when you call the Input subroutine: the I must be upper case and all the other letters must 
be lower case; otherwise there will be a conflict with the BASIC keyword INPUT. The name Input 

doesn't work at all with Pascal (another keyword conflict), so Read channel was chosen instead. 

Whatever the name, the subroutine works the same way in either language. 

Note that if you specify the optional parameters for gain and/or pace interval, they override the 
existing values only for the duration of the subroutine call. After the call has completed, the gain and 
pace interval parameters revert to their previous values. 
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The operation of the Input subroutine in interrupt mode is different from its normal operation. Refer 
to the discussion of interrupt mode, later in this section, for more details. 

Sequential scan. Use the Sequential scan subroutine to take readings on all channels in sequence 

from a starting channel to an ending channel. These readings are all taken at the same pace rate (which 

you specify) and the same gain (specified by the most recent call to Config or Set gain), and the 

values are returned to a data array. Optionally, you can repeat the readings as many times as you want. 
For example, if you wanted to take readings from channels 2 through 7 on an ADC card, at the same 
gain and pace rate, Sequential_scan would be the appropriate subroutine to use. 

In BASIC: 



100 INTEGER Start, Stop, Repeat 
110 REAL Data(1:6) 



230 


Name$="ADC" 


240 


Start=2 


250 


Stop=7 


260 


Pace=0.01 


270 


Rept=1 



460 Sequential scan (Name$, Start, Stop, Pace, Data (•) ,Rept) 



In Pascal: 



CONST name = 'ADC; 
pace = 0.01 ; 
start = 2; 
stop = 7; 
rept ■ 1 
d size = 6; 



TYPE d_array = ARRAY [1..6] OF real; 
d ptr s A d array; 



VAR 



data: d_ptr; 



new(data) ; 

sequential scan (name, start, stop, pace, d size, data, rept) ; 
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You must make sure that your data array is large enough to hold all of the readings that the 

Sequential__scan call will generate. Note that if the call to Sequential scan aborts, the contents of the 

array will be undefined. (This is because the Sequential scan subroutine uses the array space as 

temporary storage for a variety of nasty, messy variables; it doesn't fill the array with nice, clean data 
until just before it returns to your program. If the subroutine aborts while the array space is filled with 
garbage and your program tries to interpret the garbage as data, you may not be pleased with the 
results. ) 

The pace interval that you specify when you call Sequential scan will be maintained only for the 

duration of that call. After the readings have been taken, the pace interval will revert to its previous 
value. 



Random scan. Use Random scan when you need lots of flexibility. Random__scan lets you read 

from the channels on a card in any order, and you can assign an individual pace interval and gain for 
each reading. Additionally, you can repeat the set of readings as many times as you want. 

The readings are controlled by a set of arrays. A channel array lists the order of the channels to be 
read. A gain array lists the gains for the readings. A pace array lists the pace intervals that will elapse 
between readings. And a data array stores the results. The sizes of the channel, pace, and gain arrays 
need not be the same. The Random__scan subroutine simply starts at the beginning of each array and 
uses the values in sequence. After Random_scan uses the last element in an array, it goes back to the 
beginning of the array for the next value. (Note that the gain and pace values do not start over just 
because the channel array repeats. ) 

For example, consider an ADC card that has flowmeters attached to channels 2, 3, 4, and 5, and 
thermocouples attached to channels 6 and 7. Say that you wanted to take the following sets of 
readings 

Channel 2 3 6 4 5 7 
Pace .02 .02 .02 .02 .02 .02 

Gain 1 1 64 1 1 64 

To take these readings, you could set up the following arrays: 

Channel 2 3 6 4 5 7 

Pace . 02 

Gain 1 1 64 
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In taking readings from the channels in the channel array, the Random_scan subroutine will use the 
pace array six times and the gain array twice. 

The call sequence to take those readings once would be, in BASIC 

« 

110 INTEGER Channel(1:6) 

120 REAL Pace(1:1) 

130 INTEGER Gain (1:3) 

140 REAL Data(1:6) 

150 DATA 2,3,6,4,5,7 

160 READ Channel (») 

170 DATA .02 

180 READ Pac«(«) 

190 DATA 1,1,64 

200 READ Gain («) 

• 
« 

320 Repeat =1 

330 RandoiR_8can( H ADC H ,Channel(«),Data(4»),Rapaat,Paca(«),Gaih(«)) 
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In Pascal the sequence would be: 



CONST name = 'ADC'; 
start s 2; 
stop « 7; 
rapt ■ 1 ; 
d_8ize « 6: 
p_8ize ■ 1 
g_size « 3; 
c~eize « 6; 

TYPE r_array « ARRAY [1..6] OF real; 

r~~ptr * *r array; 

farray = ARRAY [\..G] OF ahortint; 

i~P tr ■ A i_array; 

VAR data: rj>tr; 

channel? i_ptr; 
pace: r_ptr; 
gain: i~ptr; 



new (channel) 
channel~[l] 
channel" [2] 
channel* [3] 
channel" [4] 
channel* [5] 
channel* [6] 
new (pace); 
pace*[1] 
new(gain) 
gain*[1] 
gain*[2] 
gain*[3] 



2; 
3; 
6; 
4; 
5; 
7; 

0.02; 

i; 
1; 

64; 



new(data); 

random_scan (naae, 

"" c_tize, channel, 

d~*ize,data, 
rept, 

p_size,pace, 
g~tize,gain); 
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In the general case, the ith reading is taken using the following array elements: 

Channel: chan_array[i mod size_of (chan_array)] 

Pace: pace_array[i mod size_of (pace_array)] 

Gain: gain~array[i mod size_of (gain_array)j 

Data: dataji] 

Make sure that the data array is large enough to hold all of the readings that will be generated by the 
Random_scan call. (Don't forget to account for repeats.) As with Sequential_scan, if the call to 
Random_scan aborts, the contents of the array will be undefined. 

The channel, pace, and gain arrays must be dimensioned as arrays, even if they are only single-valued. 
Scalar variables can not be used. 

The pace and gain values specified in Random_scan are used only for the duration of the 
R.andom_tcan call After the readings have been taken, pace and gain revert to their previous values. 

Special Considerations in Taking Readings 

Timing of readings. Even though the Measurement Library can take readings at the full 55 kHz 
sampling speed of the ADC card, it can't return the results to your program that fast The reason for this 
is the system overhead of BASIC or Pascal and the overhead of the Measurement Library itself. For any 
given set of readings the Measurement Library goes through the following steps: 



a) Set up the card. 

b) Take the reading(s) at the specified pace rate. 

c) Convert the readings to the requested data format 
sure there wasnH a pacing error.) 



(This includes checking the WATT bit to make 



The values below indicate the time required to process a reading sequence. The total time required is the 
sum of item (a), item (b), and the appropriate value from item (c). Note that these are worst -case values. 
You would get these values from Series 200 computers using an 8 MHz MC68000 processor chip and no 
floating point math card. Processing times will be shorter for computers with later (faster) processor chips 
and/or floating point math cards. 



BASIC 



Input 

aj Set-up time: 

b) Read time: 

c) Data converaion time 

BASE unite: 
STANDARD unite: 



2.0 meec 

(pace interval) • (one reading) t 

1 .0 meec 
1 .9 meec 



USER unite: 2.5 meec 



Sequential scan 

a) Set-up time: 

b) Read time: 

c) Data converaion time 

BASE unite: 

STANDARD unite: 

USER unite: 



3.5 meec + 0.1 meec per reading 

(pace interval) * (number of readings) 

0.3 m8ec per reading 
1 .2 meec per reading 
1.5 meec per reading 
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Random scan 

a) Set-up time: 

b) Read time: 

c) Data conversion time: 

BASE units: 

STANOARD units: 

USER units: 



PASCAL 



Read channel 

a) Set-up time: 

b) Read time: 

c) Data conversion time 

BASE units: 

STANDARD units: 

USER units: 



3.0 msec +0.4 msec per reading 

(pace interval) * (number of readings) 

1.3 msec per reading 
2.2 msec per reading 

2.4 msec per reading 



2.0 msec 

(pace interval) * (one reading)t 

1 . msec 
1 .9 msec 
2.2 msec 



Sequential scan 

a) Set-up time: 

b) Read time: 

c) Data conversion time 

BASE units: 

STANDARD units: 

USER units: 

Random scan 

a) Set-up time: 

b) Read time: 

c) Data conversion time 

BASE units: 

STANDARD units: 

USER units: 



3.4 msec +0.1 msec per reading 
(pace interval) * (number of readings) 

0.3 msec per reading 
1.0 msec per reading 

1.5 msec per reading 



1.2 msec + 0.5 msec per reading 

(pace interval) * (number of readings) 



1.6 msec per reading 
2.2 msec per reading 
2.5 msec per reading 

tNOTE: "Input" (BASIC) and "Read Channel" (Pascal) take one reading each time they 
are called. Refer to page 2-9 of this manual. 

Array size limits. The Measurement Library limits your maximum array size to 1 6,777,2 1 5 bytes. That's 
really a hardware limit, imposed by the width of the address bus on HP 9000 Series 200 and Series 300 
computers. At 8 bytes per reading that works out to a maximum of 2,097,1 50 readings from any one call 
to the Measurement Library, hardly a severe restriction. In practical terms, you will be limited by the size 
of your physical memory long before you run into the Measurement Library limit. 

How your system lets you access that memory can be a different story. It's no problem in a Pascal system, 
since you can easily allocate an array large enough to take up all of your physical memory. Things are a 
bit more subtle in BASIC, however. 

At first BASIC appears to limit you to 32767 readings from any single call to the Measurement Library, 
since that's the largest number you can specify as an array dimension. But you can exceed that number of 
readings by using a multi -dimensional array. You can easily fill up all the memory you have using a 
two-dimensional array. (BASIC allows you up to six dimensions in your arrays, so you can arrange your 
data in whatever format is convenient.) The Measurement Library doesn't care if your array is 
multi -dimensional; all it wants is the starting address of the array (which you supply by passing the name 
of the array in the subroutine call). The only thing you have to take care of is reading your data out of 
the multi -dimensional array in the correct order. 
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(Note that the ability to specify large data arrays does NOT constitute a continuous data acquisition 
(CDA) scheme. The amount of data you can collect with the Measurement Library subroutines is limited 
by the amount of memory in your computer. The Measurement Library has no provision for, say, logging 
high-speed data to a disc for indefinite periods without missing readings.) 



The Pipeline 

The ADC requires three operations to produce a reading: 

1) provide the channel address for the reading 

2) latch the voltage and convert it to a digital value 

3) return the value to the host computer 

For any given reading, these three operations must be done serially: 

+ + + + 

| address | convert | return j 

+ + + + 

time > 



Figure 1-1. Analog input operation 

However, to maximize throughput, the ADC card "pipelines" the readings. That is, while the value for one 
reading is being returned, the voltage for the next reading is being latched and converted, and the channel 
address is being provided for the reading after that. For example, during time period t3 in the figure 
below the first reading is taken from the card while the second reading is being converted and the third 
address is being supplied. 



+ + 

| add res 8 1 | convert 1 | 



| address 2 | 

+ +j 



tl 



time 



t2 




r»nHw» ■ aQ, dress ^ | convert 4 | return 4 

;.ti hi-sijjnj 
■a iLiuS!" ' 

iili.'ifijiilL.,- 



t6 



Figure 1-2. Analog Input Pipeline 

To start the flow of readings, the Measurement Library software primes the pipeline by taking two 
"garbage" readings (at times tl and t2 in the figure above); these two readings are thrown away. (Their 
only purpose was to start pulling valid readings through the pipeline.) The third reading taken is the first 
valid reading, since it is the first reading that has gone through all three stages of the pipeline; it is 
written into the data array as the first reading. 

For all readings taken in normal mode, the Measurement Library software takes care of priming and 
emptying the pipeline; it does this by taking two more readings than are requested and throwing away the 
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two extra garbage values. This happens for each subroutine call; you never have to pay any attention to 
it, since the software takes care of it all 

(Note that since each subroutine call incurs the extra time required for two readings, it is difficult (if not 
impossible) to maintain accurate and even pacing of readings between one subroutine call and the next If 
your application requires accurate pacing for a block of readings, we suggest that you make all of those 

readings with one subroutine call. Use Sequential scan or Random scan, as appropriate to your 

application.) 

For readings taken in interrupt mode, the Measurement Library software does not take care of the 
pipeline for you. You must keep track of which readings are which (not a very taxing operation) and 
throw out the garbage. More information on interrupt mode programming is contained later in this 
section. 



Overrange Errors 

You can encounter two kinds of overrange conditions with the ADC card: normal mode overrange and 
common mode overrange. Normal mode overrange occurs when the input voltage exceeds the range of 
the analog*- to-digital converter. Common mode overrange occurs when either side of the differential 
input voltage exceeds the maximum input voltage of its input amplifier. The next several paragraphs 
explain how these overrange conditions can affect your readings. 

The voltage measured by the ADC card is the differential input voltage between the + Input and - Input 
terminals of a channel on the card. The two sides of the input signal pass through separate input 
amplifiers (op amps), and are then sent to an analog -to -digital (A-to-D) converter for conversion to a 
numeric value. (The figures below show this circuit configured for a gain of 1.) 

There are a couple of limitations that apply to this measurement circuit: 

1) The voltage output from an input op amp can not exceed ± 1 volts, relative to system ground. For a 
gain of 1, this also means that the input voltage applied to the op amp can not exceed ±10 volts, 
again relative to system ground. (The situation gets rather more complicated for gains greater than 
one; the formula for figuring the maximum input voltage is somewhat abstruse, involving various 
voltages, gains, and a couple of 2s. We won't get into the mathematics of it, but figure 1-6 shows an 
example of the results that you may see.) Exceeding this input limit causes a common mode 
overrange: the output of the op amp is clipped at its limit (+10 volts or -10 volts) and the overrange 
flag (the O bit in a base unit reading) is set to 1. 

2) The A-to-D converter, which compares the outputs of the op amps, can not measure a difference of 
more than 10 volts. If the difference between those outputs is more than 10 volts, the A-to-D 
converter clips its output value to 1 volts; this situation is defined as a normal mode overrange. 

The next few figures show various combinations of input voltages and the outputs they produce. In the 
figures, + Input and - Input voltages (relative to system ground) are shown in "stick" type, like this: 

+ 4 
The differential input voltages are shown in Roman type, like this: 

+6 
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Figure 1-3 shows a typical reading that causes no problems. The input voltages propagate through the 
op amps with no clipping, the differential voltage is well within the range of the A-to-D converter, and 
the converter comes up with the correct value. 



+4 




+4 



+6 



+6 




-2 



A-to-D 
Converter 



4-6 



Figure 1-3. Reading OK 

Figure 1-4 shows a normal mode overrange condition. The + Input and - Input voltages are within the 
range of their respective op amps, but the differential input voltage (+12 volts) is too great for the 
A-to-D converter. The result is a normal mode overrange condition, yielding a full-scale (and 
incorrect) reading from the A-to-D converter. 



+6 




+6 



+12 



+ 12 



-6 




A-to-0 
Converter 



+10 



Figure 1-4. Normal mode overrange 
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Figure 1-5 shows a common mode overrange condition. The + Input voltage of +12 volts is clipped to 
+10 volts and the overrange flag (O bit) is set to 1. The differential voltage presented to the A-to-D 
converter is within the range of the converter, so it converts the voltage correctly and comes up with 
the wrong answer. 



+12- 




+ 10 



+4 



+2 



+8 




+8 



A-to-D 
Converter 



+2 



Figure 1-5. Common mode overrange 

Figure 1-6 shows a subtler form of common mode overrange that you may encounter at gains greater 
than 1. This is because the programmable gain amplifier amplifies the difference between the + Input 
and -Input voltages before sending the result to the A-to-D converter. Even though the input 
voltages appear to be acceptable, the amplifier may try to boost them out of the acceptable range. In 
this case, the programmable gain circuit tries to boost the + Input voltage to 1 1. 5 volts, but the output 
limit of the op amp keeps the voltage from exceeding +10 volts. The overrange flag (O bit) is set to one 
and the clipped voltage is sent to the A-to-D converter. The resulting value is incorrect. 



+8 




+10 
+1J£ 



+ 1 



+6.5 



+7 




A-to-D 
Converter 



+6.5 



+3.5 



Gain = 6 



Figure 1-6. Common mode overrange at gain greater than 1 



A normal mode overrange is indicated when a reading returns the maximum possible magnitude value. 
(This is the same as "clipping". ) The maximum magnitude value depends on the units in use, as follows: 

Base: 4095 (all D bits set to 1) 
Standard: (4095 * Isb - calibrate) / gain 
User: ((4095 * lsb - calibrate) / gain) * multiplier + offset 
where: lsb - 10 / 4095 volts/bit 
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Note that it is not possible to tell the difference between a full scale reading and a normal mode 
overrange reading. 

By default, a normal mode overrange condition does not generate an error. However, by setting a 

parameter in the Config call you can cause an error to be generated when a normal mode overrange 

occurs. 

Common mode overranges are harder to detect than normal mode overranges, since the value of the 
reading may appear to be correct even though an overrange has occurred. For this reason, common mode 
overranges are trapped as errors. 

Note that the Measurement Library reports errors for normal mode and common mode overranges only 
when you are operating in standard or user units. If you are operating in base units, no error will be 
reported. To detect a normal mode overrange in base units, check the D bits for a full scale reading; to 
detect a common mode overrange, check the O bit 

Pacing Errors 

The pace counter on the ADC card is used to determine the duration of the sample portion of the sample 
and hold cycle. The hold portion is always 9 microseconds, and the minimum sample portion is 9 
microseconds. The Measurement Library lets you specify a pace interval that is the sum of these two time 
periods. Thus you can set the pace at which readings are taken for ease in making accurate time domain 
measurements of time -varying quantities. 

If, due to outside factors (concurrent I/O transfers, keyboard interrupts, and so on), the Measurement 
Library software is unable to read from the ADC card fast enough to keep up with a programmed pace 
time, a pacing error will occur. This gives you the assurance that, in the absence of such errors, the time 
domain measurements are being accurately paced. 

While the ADC card and the Measurement Library are fully capable of taking readings every 18 
microseconds, the variable gain input amplifiers on the card are not capable of slewing from maximum 
positive to maximum negative during the 9 microsecond sample period that this pace rate requires. This 
puts an upper limit on the signal frequency component that the ADC can measure accurately at the 18 
microsecond sample rate. The following table shows that maximum frequency component for each gain, 
for readings to within 1 lsb on a single channel. 

Maximum Signal 
Gain Frequency Component 



1 


27 kHz 


8 


27 kHz 


64 


15 kHz 


512 


3.5 kHz 
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When more thin one channel is being sampled (as in Sequential, 
speed of accurate sampling by the ADC is limited ts follows: 



.scan and Random_scan operations) the 



Minimum Pace Time for 
Gain Multichannel Scans 

1 50 microseconds 

8 50 microseconds 

64 71 microseconds 

512 1000 microseconds 



Equivalent Maximum 
Sampling Speed 

20000 readings per second 

20000 readings per second 

14000 readings per second 

1000 readings per second 



Interrupt Mode 

Interrupt mode operation is supported only in the BASIC language system. (It is NOT supported in 
Pascal.) Interrupt mode is useful when you want your program to continue execution between readings 
and still maintain an accurate or externally controlled pace rate. There are two subroutines associated 

specifically with interrupt mode: Enable intr and Disable_intr. Appropriately enough, interrupt mode 

is enabled by a call to Enable intr and is disabled by a call to Disable intr. 

Only a limited subset of Measurement Library subroutine calls are allowed after you have entered 
interrupt mode: 

Input 

Config_0 

Init 

System init 

Disable__intr 

Use of any other Measurement Library calls in interrupt mode will result in an error. 

When you are in interrupt mode, the Measurement Library does not automatically take care of setting up 
and clearing out the input pipeline. (Refer to the description of the analog input pipeline earlier in this 
section. ) Thus, when you take a reading with the Input subroutine, the result you get is the value of the 
reading taken two readings ago. You should discard the data returned from the first two Input calls. 

Interrupt mode does not handle multiple configurations of the same card cleanly. To avoid taking 
erroneous readings, do not take readings from different configurations (names) for the same card while in 
interrupt mode. 

The shortest pacing interval usable in an interrupt mode application is dependent upon many factors. The 
main factors are the speed of the CPU executing the BASIC program, and the type of BASIC program 
instructions that are being executed while the ADC is taking readings. To properly understand these 
factors it is important to understand how the BASIC operating system services interrupts. When BASIC 
has been enabled to service interrupts for a specific select code with an "ON INTR sc, priority GOSUB 
label" statement and an interrupt occurs on that select code, BASIC logs the fact that the interrupt has 
occurred, but does not execute the GOSUB until BASIC has completed executing the current BASIC 
program line. 

When using the ADC library in interrupt mode and an ADC interrupt has occurred, if the time to 
complete the current BASIC program line, plus the time to execute the GOSUB, plus the time to execute 
all the BASIC lines until the ADC library "Input" routine actually takes the reading from the ADC card 
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exceeds the pace interval time, the ADC library will return an error 857 indicating that a reading was 
missed. Therefore the time to service the interrupt depends upon the BASIC program line that is 
executing when the interrupt occurs as well as the code path to the ADC library "Input" routine. 

For the faster interrupt servicing in BASIC, the following tips are offered: 

1) Make the ADC library 'Input" routine the first statement in the interrupt service routine. 

2) Keep the interrupt service routine short Remember that the pace interval period starts 
with the "Input" routine, but cannot be serviced until the interrupt service routing 
"RETURN" statement has been executed. 

3) Avoid BASIC instructions which take long times to execute like input/output operations or 
matrix operations on large arrays. 

4) Avoid other interrupt processing at a higher priority than the ADC interrupt service 
routine. 

5) Set the 98640A ADC card at the highest physical interrupt level possible (in this case 6). 
See the 98640A Reference Manual, HP part number 98640-90001, for details. 

When using the interrupt mode it is important to determine experimentally that the pace interval being 
used is compatible with the BASIC program instructions being executed while waiting for interrupts on 
the particular computer family on which the program is executing. 

The following example shows a BASIC program that takes readings in interrupt mode. Its purpose is to 
take 8 voltage readings; to do that it takes 1 readings and ignores the first 2 (invalid) readings. 

40 REAL Volts (-1:8) 
50 1=2 

• 

110 Conf ig ( M ADC" » "98640A M , 1 8 , 1 , . 036 ) 

120 In it ("ADC") 

130 Enable__intr("ADC") 

140 ON INTR 16 GOSUB Service 

150 Input ("ADC'\5,Volts(-1)) 

« 

340 Service: ! 

350 Input ("ADC'\5»Volts(I-2)) 

360 1=1+1 

370 IF I > 10 THEN 

380 OFF INTR 18 

390 Disable intr("ADC") 

400 FOR J=1~TO 8 

410 PRINT Volts (J) 

420 NEXT J 

430 STOP 

440 END IF 

450 RETURN 

460 END 
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Note that the order of the Enable intr call and the ON INTR statement is not critical. Enable intr 

does not physically enable interrupts on the ADC card; it only sets flags in the Measurement Library. The 
card interrupts are physically enabled by the first Input call after Enable intr (line 1 50 in this example). 



Externa! Pacing 

You might use external pacing for ADC readings if: 

— you want to use a pace interval longer than that allowed by the Measurement Library software 
(0.0393336 second) 

— you want the readings to be controlled by an external event, rather than by time 

External pacing is primarily a hardware operation. It is largely controlled by two hardware control lines, 
DPACDA (internal pace disable) and EPCON (external pace control). There's not a lot of software 
involvement, other than making the read requests that you would normally make for an internally paced 
read. The timing of the execution of those read requests is controlled by the hardware. (There's no 
provision in the software for controlling IPACDA and EPCON directly; you'll have to build your own 
circuits to control them. ) 

In the next several paragraphs we will look at some of the features of the hardware and software that 
affect external pacing, and then we will see how they fit together in external pacing applications. In this 
manual we'll limit our discussion of the hardware to telling you when the IPACDA and EPCON control 
lines must be set low or high; we wont give you instructions for building the circuits that control those 
lines. You can, however, get more information about those control lines from the ADC hardware manual, 
part number 98640-90001. 

Hardware Considerations 

There are two control lines of interest for external pacing: 

IPACDA determines whether the readings are paced by the internal pacing timer on the ADC card. If 
IPACDA is low, the internal pacing timer of the card is used; if IPACDA is high, the internal pacing 
timer is bypassed and readings are taken at the free run speed of the card (one reading every 1 8 
microseconds). Note that IPACDA must be high when readings start in order for the timing of the first 
reading of a series to be accurately known. (IPACDA can be set low after the start of readings if you 
want the readings to be paced by the internal pacing timer.) 

EPCON controls whether or not any readings are taken. If EPCON is low, readings are taken whenever 
they are requested. If EPCON is high, requested readings are held off; a read request will not complete 
until EPCON goes low again. 

In summary, when EPCON is low, readings are taken at the free run speed of the card (if IPACDA is high) 
or at the time programmed into the internal pacing timer (if IPACDA is lowX When EPCON is high, 
readings stop. 
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Software Considerations 

When making externally paced readings, you will have to allow for the software set-up time of the 
various subroutines. 

The set-up times in the BASIC language for the reading subroutines are: 

Input 2.0 milliseconds 

Sequent ial_scan 3.5 milliseconds + 0.1 milliseconds per reading 

Random_acan 3.0 milliseconds +0.4 milliseconds per reading 

Set-up times in Pascal are: 

Read_channel 2.0 milliseconds 

Sequent ial_acan 3.4 milliseconds + 0.1 milliseconds per reading 

Random_scan 1.2 milliseconds + 0.5 milliseconds per reading 

Applications 

External pacing applications divide into two general types: single readings and bursts of readings 

Single readings. The idea behind taking single externally paced readings is that you keep EPCON high 
until you want to take a reading, set it low only long enough to take the reading, and then set it high 
again. The steps in taking a single reading are: 

1 ) Set IPACDA high. IPACDA will remain high for the duration of externally paced readings. 

2) Set EPCON high. This holds off all readings. 

3) Issue a call to Input/read channel, Sequential__scan, or Random scan. 

4) Wait. The length of time you wait should be at least the set-up time. 

5) When it is time to take a reading, set EPCON low. Keep it low for 1 to 1 5 microseconds, 
then set it high again. This will allow one (and only one) reading to be taken. 

6) Repeat step 5 until you have taken all the readings that you requested with the subroutine 
call in step 3. The subroutine will return to your application program only after all 
requested readings have been taken. 

As indicated in step 4, each subroutine call you make requires that you wait the set-up time before 

pulsing the EPCON line to take the first reading. For Input (or Read channel) calls made in normal 

mode, that means that you must wait the set-up time before each reading. If you're using Input in 
interrupt mode, the set-up time is required only before the first reading. Keep in mind, however, that the 
EPCON pulses should be at least 36 milliseconds apart if you're operating in interrupt mode. 
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Bursts of Readings. The idea behind taking readings in bursts is that you request multiple readings with 
a subroutine call, and then take those readings in one burst by setting EPCON low until all of the readings 
have been taken. These readings can be taken at the free run speed of the card, or they can be paced by 
the card's internal pacing timer. The following steps are for triggering burst readings that are paced by 
the internal pacing timer. 

1) Set IPACDA and EPCON high. 

2) Make a read request by issuing a call to Sequential__scan or Random scan. 

3) Wait You should wait for at least the set-up time plus the pace interval. 

4) Set the EPCON line low. The analog -to-digital conversion for the first reading will start in 
approximately 3 microseconds. 

5) Set the IPACDA line low. This must happen 1 to 1 5 microseconds after you set EPCON 
low. 

6) Hold EPCON and IPACDA low until all of the requested readings have been taken. (The 
subroutine call will return to your application program after all of the readings have 
completed.) 

The requirement (in step 3) that you wait the set-up time plus the pace interval assures that the first 
reading occurs at a more-or-less known time (within approximately 3 microseconds after EPCON is set 
low), and that the voltage has been sampled for at least the prescribed sample time (pace interval minus 9 
microseconds). 

Combinations. You can combine the above two methods of external pacing if your application requires. 
We won*t go into those combinations here; we leave that as an exercise for the interested reader. The 
methods above should give you enough information to make your combination work. 
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Purpose: This manual explains how to use the HP 98645A Measurement Library. It assumes that you 
have a working knowledge of the BASIC or Pascal language system on the HP 9000 Series 200 or Series 
300 computers. It also assumes that you are generally familiar with the HP 98640A Analog -to -Digital 
Converter card. (Refer to the manual for that card, HP part number 98640-90001, for more 
information.) 

Organization: This manual is organized as follows: 

Section 1: How to use the HP 98645A Measurement Library. 

Section 2: Alphabetical listing of Measurement Library subroutine calls. 

Appendix A: Error messages. 

Appendix B: Quick reference guide to Measurement Library subroutine call syntax. 
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CONFIG O 



Config sets up an HP 98640A ADC card for access by the Measurement Library subroutines. 



Syntax 

BASIC: Conf ig_0(name, model [, select code [, gain [, 
pace [, report errorT»unita[, 
multiplier[,of feet] ]]]]]]) 

Pascal: PROCEDURE config_0(name: str255; 

model: str255; 
select_code: short int; 
gain: ehortint; 
pace: real; 
reportjerror: etr255; 
units:~str255; 
multiplier: real; 
of feet: real); 



Parameters 

name: 

model: 
select_code : 

gain: 



a string or at ring literal specifying the name used by the 
Measurement Library software to rafer to a particular ADC 
configuration. 

a string or string literal identifying tha ADC card modal 
number ("98640A"). 

an INTEGER giving tha physical salect coda (address) of the 
ADC card. This number ie between 8 and 31, and ie eet fay 
hardware ewitchee on the card (SW1 » awitchea 1 through 5). 



an INTEGER specifying the default ADC hardware gain, 
value muet be 1, 8, 64, or 512. 



Tha 



a REAL number defining the default pace time loaded into the 
pace counter. This value can be from 0.000018 to 0.0393336 
seconds, with a resolution of 600 nanoseconds. 

a string or string literal enabling an error condition on 
normal mode over range readings. Tha value can be either yee 
or no. (Only the firet character ie sign if leant; only "y" 
and "Y" are taken ae yee, all othere indicata no.) 

a string or string literal specifying the units to used to 
return ADC data. The unite can be baes, standard, or user. 
(Only the first character ie significant.) 

base = binary data read directly from the ADC 
standard ■ (base • ADC Is b - calibrate) / gain 
user ■ etandard * multiplier + offset 

multiplier: a REAL number specifying the multiplier used with user unite. 



pace: 



rmportj error: 



unite: 
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offset: a REAL number specifying the offset used with user units. 

Default values: 



select code 


18 


gain 


1 


pace 


.001 second 


report_error 


no 


units 


standard 


multiplier 


1.0 


offset 


0.0 


Discussion 





Config establishes a link between a name (which you supply) and an ADC card, and specifies operating 

parameters for that name and card. Each ADC card used must be configured with a unique name. You 
can configure the same card with several different names and parameter sets, and everything will work 
except interrupt mode data transfers. DO NOT ATTEMPT TO ACCESS AN ADC BY ANOTHER NAME 
DURING INTERRUPT MODE DATA TRANSFERS. 

A maximum of 1 6 names may be configured into the Measurement Library software. If you need more 
configurations, names may be re-used. If a name is identical to an already used name, all configuration 
parameters for the old name will be erased and the new configuration parameters or defaults will be used. 
The name will then have to be reinitialized with Init before it is accessed. 

All readings taken by the ADC are reported in one of three reporting units: base, standard, or user. Base 
units are in the form of a 16 -bit binary integer, with the following format 

15 14 13 12 11 10 98765432 1 
+ + + + + + + + — + + + + + + — + + + 

|B|W|O|-S|D.-|D|D|D|0|0|D|D|D|0|D|D| 

+ ♦ ♦ + + + + ♦ — + + + + + + + + — + 

MSB LSB 

where: 

B - BUSY. If bit 15- 1, the ADC is busy. The reading is not taken and all other bits are invalid. If bit 
1 5 « 0, a valid reading is returned. 

W « WAIT. If bit 14 • 1, the ADC card was in the wait state at the time of the reading. This means 
that the card was not read within the interval specified in the pacing timer -- that is, a paced read 
was not made at the correct time. (Generally you will not see this bit set, since the ADC Library 
software reports an incorrectly paced read as an error and will not return a value for the reading.) 

O * OVERRANGE. If bit 1 3 - 0, a common mode overrange condition occurred during this reading, 
and the reading is invalid. If bit 13 * 1, no common mode overrange condition occurred during this 
reading. Note that the sense of this bit is negative true. 

S ■ SIGN. If bit 12 ■ 0, the value returned for the reading is positive. If bit 12 ■ 1, the value returned 
for the reading is negative. 



Update 1 (November 19 85) 
2-4 



ADC card 

calibration, 1-7 

configuration, 1-5, 1-8, 2-3 

configurations, multiple, 1-8, 1-21, 2-4, 2-7 

initialization, 1-5, 2-8, 2-17 

input pipeline, 1-16 

readings, 1-9 

sampling speed, 1 - 1 , 1-20 
Analog input pipeline, 1-16, 1-21 
Array size limits, 1-15 



B 

Base units, 1-1, 1-7, 1-20, 2-4, 2-16 
BASIC 

common area, 1-5 

error handling, 1-8 

extensions, 1-2 

heap area, 1-5 

interrupt mode, 1-21 

loading the Measurement Library subroutines, 1-2, 1-3 

Measurement Library subroutine size, 1-3 

parameter typing, 1-3, 1-7, 2-5 

programming, 1-2, 1-3, 1-5 



Calibrate subroutine, 1-7, 2-2, B-2 

Calibration, 1-1, 1-5, 1-7, 2-2 

Common area, 1-5 

Common mode overrange condition, 1-7, 1-8, 1-17, 1-19, 1-20, 2-4 

Configuration of ADC cards, 1-5, 1-8, 2-3 

Config_0 subroutine, 1-5, 1-7, 1-8, 1-9, 1-10, 1-20, 1-21, 2-3, B-2 

Control lines, IPACD A and EPCON, 1-23 

CSUB package, 1-1 



Data conversion times, 1-14 
Disable__intr subroutine, 1-21, 2-6, B-2 
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Enable__intr subroutine, 1-21, 2-7, B-2 

EPCON control line, 1-23 

Error handling, 1-8 

Error messages, A- 1 

Error reporting, 1 - 8 

ERRN function, 1 8 

ESC APECODE function, 1-8 

External pacing, 1-23 



G 

Gain, 1-5, 1-6, 2-15 



H 



Heap area, 1-5 

HP 1475 1A package, 1-1, 1-9, 2-1 



I 

Init subroutine, 1-5, 1-21, 2-8, 2-17, B-2 
Initializing 

ADC card, 1-5, 2-8, 2-17 

Measurement Library, 1-5, 2-10 
Input pipeline, 1-16, 1-21 

Input subroutine, 1-6, 1-9, 1-21, 2-7, 2-9, B-2 

Interrupt mode, 1-1, 1-2, 1-3, 1-4, 1-10, 1-17, 1-21, 2-4,2-6,2-7,2-9 
IPACDA control line, 1-23 



Least significant bit (LSB) values, 2-5 

Loading the Measurement Library subroutines, 1-2, 1-3 

LSB values, 2-5 



M 

Measurement Library 
features, 1-1 
general information, 1 - 1 
initialization, 1-5, 2-10 
messages, A- 2 
programming, 1-2 
quick reference, B- 1 
size, 1-3, 1-4 
software provided, 1-2 
subroutines, 1-2, 1-3 
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Meas__lib_init subroutine, 1-5, 2-10, B-2 
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Multi -dimensional arrays, 1-15 

Multiple configurations of an ADC card, 1-8, 1-21, 2-4, 2-7 



N 

Normal mode overrange condition, 1-5, 1-8, 1-17, 1-18, 1-19 



ON ERROR mechanism, 1-8 

Overrange condition 
common mode, 1-7, 1-8, 1-17, 1-19, 1-20, 2-4 
normal mode, 1-5, 1-8, 1-17, 1-18, 1-19 



Pace interval, 1-5, 1-6, 1-20 
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common area, 1-5 

error handling, 1-8 
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interrupt mode, 1-4, 1-21, 2-7 
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PREFACE 



Purpose: This manual explains how to use the HP 98645A Measurement Library. It assumes that you 
have a working knowledge of the BASIC or Pascal language system on the HP 9000 Series 200 computers. 
It also assumes that you are generally familiar with the HP 98640A Analog -to-Digital Converter card. 
(Refer to the manual for that card, HP part number 98640-90001, for more information.) 

Organization: This manual is organized as follows: 

Section 1: How to use the HP 98645A Measurement Library. 

Section 2: Alphabetical listing of Measurement Library subroutine calls. 

Appendix A: Error messages. 

Appendix ft Quick reference guide to Measurement Library subroutine call syntax. 
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INTRODUCTION 

The HP 9 8645 A Measurement Library provides a set of easy-to-use subroutines for taking readings from 
the HP 98640A Analog-to-Digital Converter (ADC) card. These subroutines can be used from the BASIC 
or Pascal language systems on the HP 9000 Series 200 computer. The subroutines are written in Pascal, 
and are adapted to the BASIC language with the CSUB utility package. The Measurement Library is 
compatible with BASIC 2. 1, BASIC 3.0, Pascal 2. 0, Pascal 2. 1, and Pascal 3. 0. 

The Measurement Library subroutine calls are a superset of the "HP 14751 A Computer Aided Test 
Programming Package for the Model 6944A". BASIC programs written using the HP 14751 A routines 
should be able to use the Measurement Library software with very little modification. 



Features 

The HP 9 8 64 5 A Measurement Library allows you to: 

Take a single reading from any of 8 channels at any of 4 gains. 

Take readings by scanning across 1 to 8 channels, any number of times. 

Take readings from channels in random order as specified in an address array. Optionally, you can 
specify the gain and pace interval for each reading, and the readings can be repeated any number of 
times. 

Express readings in three different units 

Base units: binary integer returned from the ADC. 

Standard units: base units adjusted for gain and calibration, expressed as real numbers. 

User units: standard units times a user multiplier plus a user offset 

Take calibration (zero) readings on a specified channel, and apply that calibration adjustment to all 
readings. 

Re -set gain or units at any time. 

Take readings at the full 55 kHz sampling speed of the ADC card from either BASIC or Pascal. 

Take readings under interrupt mode in BASIC. 
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Software Provided 

The HP 98645A Measurement Library includes these subroutine packages: 

MEAS__LIB for use with BASIC 2. 
MEAS_LIB3 for use with BASIC 3.0 
INTR2__1 for use with interrupt mode in BASIC 2. 1 
MEAS_JLIB.CODE for use with Pascal 2. 0/2. 1 
MEAS__LIB3. CODE for use with Pascal 3. 

The software is provided on the following media: 

Option #630: 3-1/2" floppy disc 

Option #655: 5-1/4" floppy disc 

THE GENERAL APPROACH 

The way you write programs using the Measurement Library is pretty much the same whether you use the 
BASIC or Pascal language system. There are, however, significant differences in the way you set up your 
system environment. We will discuss these differences in the next few paragraphs. 

Using BASIC 2.1 

If you are using the BASIC 2. 1 system, take the following steps to get your application up and running: 

1) Boot up BASIC 2.0. 

2) Load the BASIC 2. 1 extensions. The 2. 1 extensions are located on the Extended BASIC 2. 1 disc. 

Insert that disc into the master drive and issue the command LOAD BIN "AP2 1". 

3) Load the interrupt processing package if you will be taking readings in interrupt mode. (Interrupt 

mode readings are discussed later in this section.) The interrupt processing package is located on the 
Measurement Library disc. Insert that disc into the master drive and issue the command LOAD 
BIN"INTR2_1". 

4) Load any other BASIC extensions that you need for your application. For example, this would be 

the time to load Graphics 2. 1 . 

5) Write your BASIC program or load a previously written program into memory. In the paragraphs 

below we will describe how to write your application program using the Measurement Library. 

6) Load the Measurement Library subroutines if they are not already part of the program you wrote 

in the previous step. The subroutines are located on the Measurement Library disc. Insert that disc 
into the master drive and issue the command LOADSUB ALL FROM "MEAS_LIB". 

7) Run your program. Debug as necessary (repeating steps 5 through 7). 
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Using BASIC 3.0 

If you are using the BASIC 3. system, take the following steps to get your application up and running: 

1) Boot up BASIC 3.0. 

2) Load the BASIC 3. IO binary if you will be taking readings in interrupt mode. (Interrupt mode 

readings are discussed later in this section. ) The IO binary is located on the BASIC 3. Language 
Binary disc. Insert that disc into the master drive and issue the command LOAD BIN "IO". 

3) Load any other BASIC binaries that you need for your application. For example, this would be the 

time to load graphics routines. 

4) Write your BASIC program or load a previously written program into memory. In the paragraphs 

below we will describe how to write your application program using the Measurement Library. 

5) Load the Measurement Library subroutines if they are not already part of the program you wrote 

in the previous step. The subroutines are located on the Measurement Library disc. Insert that disc 
into the master drive and issue the command LOADSUB ALL FROM "MEAS_LIB3 ,, . 

6) Run your program. Debug as necessary (repeating steps 4 through 6). 



General BASIC Programming 

The Measurement Library subroutines add approximately 23,700 bytes to your BASIC program. The 
INTR2 1 binary adds approximately 1200 bytes. 

Note that integer parameters used in the Measurement Library subroutine calls must be explicitly typed as 
INTEGER. (You can find out which parameters are integers by looking at the parameter descriptions in 
the subroutine call listings in Section 2 of this manual.) Real parameters and string parameters (those 
ending in $) need not be explicitly typed. Literal constants of any type (integer, real, or string) may be 
used. Note that integers must not contain a decimal point. 

You can invoke Measurement Library routines by calling them (CALL statement) or simply by entering 
them by name. When you use them in an IF . . THEN statement or an ON . . statement, the "CALL" 
must be explicit. 



Using Pascal 2.0, 2.1, or 3.0 

You can call the Measurement Library subroutines from the Pascal language by importing the 
Measurement Library and using the library subroutines as procedure calls with the syntax described in 
Section 2 of this manual. Typically, you import the Measurement Library with a compiler directive of 

ISEARCH 'MEAS_LIB'$ 
or 

ISEARCH 'MEAS_LIB3'$ 
and an import statement of 
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IMPORT measurement^ ib; 

in your code. Importing the Measurement Library adds about 17600 bytes to your Pascal program. 

If the Pascal system modules INTERFACE and IO have not been merged into the system library file, you 
will also have to include the compiler directive 

$SEARCH 'INTERFACE. ','10. '$ 

Note that the ". " after each file name is significant. 

The procedure calls for the Measurement Library are all exported from the file MEAS LIB. CODE (or 

MEAS_LIB3.CODE), along with the following types: 

TYPE shortint = -32768.-32767; 
byte « 0..255; 
str255 = 8tring[255]; 

iarraytype = ARRAY [0. .max in t] OF shortint; 
rarraytype * ARRAY [0. .max in t] OF real; 
rarraypt = "rarraytype; 
iarraypt ■ "iarraytype; 

Due to the rigorous structure of the Pascal language, you can't default parameters in the procedure calls. 
However, to save you the bother of declaring real and integer arrays for the pace and gain array 

parameters of the random scan procedure, you can use the default pace or gain value (established by a 

call to Config or Set_gain) by specifying a for the array size and a NIL for the array pointer. All 

other parameters for all procedure calls must be explicitly provided in the procedure call as real, integer 
(or shortint), or string variables, or as constants or literal constants. For all array parameters, make sure 
that the array elements are of the correct type, real or shortint; do not substitute integer for shortint. 
And take care that the size parameter you pass for an array does not exceed the actual size you declared 
for that array. (If you exceed the declared array size, you can write all over the other variables in your 
program, and cause yourself much anguish. ) 

Once your Pascal program has been written and compiled, it must be merged or linked to the 
Measurement Library using the Pascal system librarian program. Be sure to transfer ALL the modules in 

MEAS LIB or MEAS LIB 3. If IO is not in your system library file you will also have to transfer the 

module IOCOMASM from the file IO (found on your LIB: disc). 

Interrupt mode operation is not supported in the Pascal environment. (That means we don't guarantee 
that it will work. If you try it and it doesn't work, you can purchase consulting services from the nearest 
HP sales and service office. See the back section of this manual for a list of sales and service offices. ) An 
interrupt service routine (ISR) is required for interrupt mode to work in Pascal, and we do not provide a 
Pascal ISR with the Measurement Library. If you try to use interrupt mode in Pascal without a proper 
ISR, you will probably crash your system. If you're an experienced Pascal programmer, you may be able to 
write your own ISR. For more information on ISRs, refer to the Pascal 2.0 System Designer's Guide, part 
number 09826-90074. 

WRITING THE PROGRAM 

In both BASIC and Pascal, writing your application program involves two major activities: setting up the 
card to take readings, and taking the readings. In addition, BASIC programs may take readings in 
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interrupt mode. We will cover these subjects in the paragraphs that follow. We will also say a few words 
about externally paced readings. 

All of the subroutine calls referred to below are described in detail in Section 2 of this manual. 



Setting Up 

Setting up an ADC card for readings requires allocation of a common area, as well as calls to at least three 
subroutines: Meas lib_init, Config 0, and Init. 

The common area serves as the heap space for the subroutines in the Measurement Library. It is allocated 
automatically in Pascal; in BASIC you must allocate it explicitly at the beginning of your program. 
Reserve this area by including the following statement in your program: 

20 COM/Heapcom/ INTEGER Heaparea(1 :n) 

where n is the size of the Heaparea array. The size of Heaparea is determined by the number of 
configured names for ADC cards (more about that later) and the number of readings taken for calibration 
(ditto). Use S3 integers for each ADC card configuration and 4 integers for each reading used in 
calibration. We recommend using Heaparea(l:l 300); this allows all 16 possible ADC card configurations 
and a calibration run of 1 00 readings. 

In both BASIC and Pascal, the subroutine calls to Meas lib init, Config 0, and Init do the following: 

Meas lib init initializes the Measurement Library, and must be called before any other subroutines in 

the library are called. Meas lib init needs to be called only once in your program. 

Config sets up an ADC card for taking readings. At a minimum, you specify a name by which you 

will call the card and the model number of the card. In addition, you can specify the select code of the 
card, its gain, a pace rate for taking readings, an error reporting parameter for normal mode overrange 
errors, and the units (base, standard, or user) in which the readings will be reported. (Reporting units 

are discussed below.) If you do not supply these optional parameters, Config will supply default 

values. 

Init resets an individual card, disables interrupts for that card, and sets the calibration array for that 

card to its default values. Init must be used before any other calls except Meas lib init, Config 

and System init. System init is the same as Init, except that it initializes all cards that have been 

configured. 
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The set-up portion of a typical BASIC program might look like this: 



20 COM/Heapcom/ INTEGER Heaparea(1 : 1300) 

30 INTEGER Select_code, Gain 

40 Name$="ADC" 

50 Model$="98640A" 

60 Select_code=18 

70 Gain=1~ 

80 Pace=0.01 

90 Error$= M No M 

100 Unit$="Standard" 



220 Meas_lib in it 

230 Conf ig_olName$, Mode 1$, Select code, Gain, Pace, Error$,Unit$) 

240 Init(Name$) 



The analogous Pascal code would look like this: 



CONST name ■ 'ADC'; 

model = '98640A'; 
select__code « 18; 
gain * 1; 
pace = 0.01 ; 
error * 'NO'; 
units = 'STANDARD'; 
multiplier ■ 1 .0; 
offset =0.0; 

BEGIN 

meas_lib init; 

conf ig_oTname,model,select_code, gain, pace, error, units, mult ip lie r, off set) ; 

init(name); 



The most frequently used configuration parameters can be reset without reconfiguring the card; these 

parameters are gain, pace interval, and units. The gain can be reset with a call to the Set gain 

subroutine, or a new gain can be specified as a parameter to the Input or Random scan subroutine. (The 

Input and Random scan subroutines are used to take voltage readings from the ADC; they are described 

later in this section.) A new pacing interval can be specified as a parameter to the Input, 

Sequential scan, or Random scan subroutine. And the units can be reset with a call to the Set units 

subroutine. (Note that if you specify pace or gain parameters in an Input, Sequential scan, or 

Random scan call, the specified pace or gain value holds only for the duration of the call; it reverts to its 

previous value after the call completes. ) 
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Calibration 



Calibration gives you a way of compensating for offsets that are inherent to the ADC card To use the 
calibration feature, you must first reserve one of the channels on the card and short the + Input and 
- Input terminals on that channel to card ground. Then use the Calibrate subroutine to take a specified 
number of readings from that channel at a specified pace rate. The readings are taken at each of the gain 
settings and the average at each gain is saved. These average readings are then used to calculate 
correction values for positive and negative readings at each gain setting. When a subsequent reading is 
taken on any of the other channels, the appropriate correction value is subtracted from the raw reading 
before conversion to standard or user units. 



Reporting Units 

Reporting units come in three flavors: base, standard, and user; you specify one of these with the 
Config or Set units command. The units are: 

Base units. Base units are in the form of a 16 -bit binary integer, of which twelve bits represent the 
magnitude of the reading. Readings reported in base units are raw readings; gain factors and 
calibration corrections are not applied to base units. The format of a base unit reading is: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 

4. + 4. + 4. + 4. + 4. + 4. + 4. 4, 4. 4. 4. 

|B|W|0|S|D|D|D|D|D|D|D|D|D|D|D|D| 
4. 4. — 4. 4. 4. 4 4. 4. + 4. 4. 4. 4. 4. 4. 4. 4. 

where: 

B » BUSY. If bit 1 5 ■ 1, the ADC is busy. The reading is not taken and all other bits are invalid. If bit 
1 5 ■ 0, a valid reading is returned 

W » WAIT. If bit 14 ■ 1, the ADC card was in the wait state at the time of the reading. This means 
that the card was not read within the interval specified in the pacing timer — that is, a paced read 
was not made at the correct time. (You should never see this bit set, since the ADC Library software 
reports an incorrectly paced read as an error and will not return a value for the reading. ) 

O ■ OVERRANGE. If bit 1 3 ■ 0, a common mode overrange condition occurred during this reading, 
and the reading is invalid. (Common mode overrange errors are discussed later in this section. ) If bit 
13 s 1, no common mode overrange condition occurred during this reading. Note that the sense of 
this bit is negative true. 

S * SIGN. If bit 12* 0, the value returned for the reading is positive. If bit 12" 1, the value returned 
for the reading is negative. 

D ■ DATA. The data bits give the 1 2 -bit binary magnitude of the voltage read from the ADC (The 
sign of the voltage is given by the S bit, bit 1 2. ) 

Note that all readings taken from the ADC card by the ADC Library software are returned to your 
program through real number parameters. This includes readings in base units. Thus, while the base 
unit readings have integer values, they look like real numbers to your program until you explicitly 
convert them to integers. Assigning them to integer variables in BASIC, or using the trunc or round 
function in Pascal, will make the conversion. 
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Standard units. Standard units are base units adjusted for gain and calibration, expressed as real 
numbers. They are, in other words, volts. 

User units. User units are standard units to which a user -specified multiplier and offset have been 

applied, expressed as real numbers. You specify the values for the multiplier and offset in a Config 

or Set units subroutine call. (The default values for multiplier and offset yield standard unit values.) 

You might use user units to change the units of your readings or to compensate for a known offset in 
your readings, or both. 

For example, say you were taking readings from a 4-to-20 mA current loop transmitter connected to a 
flow meter. Say further that the range of the flow meter was from to 50 gallons per minute, and 
that you were making your voltage readings across a 250-ohm resistor. That would mean that a 
reading of 1.0 volts corresponded to a flow rate of gpm and that 5. volts corresponded to 50 gpm. 
Using y*mx+b, you can derive a multiplier of 12.5 and an offset of -12.5, and specify these as 
parameters to a Config call. 



180 Config_0( M Flow ,, , ,, 98640A ,, ,18,1,.01,"No M ,"U8er",12.5,-12.5) 



Then, whenever you take a reading from that current loop, the result is expressed directly in gallons per 
minute. That's a lot easier than making a conversion from standard units every time you take a voltage 
reading. 

Error Reporting and Handling 

The Measurement Library reports errors for a variety of reasons. Typical errors include configuration 
errors, pacing errors, and overrange errors. When such an error occurs, the Measurement Library forces a 
system error and returns the error number. Your application program can trap and handle these errors 
using the ON ERROR mechanism (in BASIC) or the Try -Recover mechanism (in Pascal). In BASIC, you 
can get the error number with the ERRN function; in Pascal, use the ESCAPECODE function. (Certain 
run time errors may be reported in BASIC as the Pascal error number plus 400. These errors are listed in 
Appendix A. ) If the errors are not trapped, your program will abort and the system will report the error. 

The errors that can be returned by the Measurement Library are listed in Appendix A. 

Note that one of the parameters of the Config subroutine determines whether normal overranges are 

reported as errors or not. Note also that if you are using base units, no overrange errors — either normal 
or common mode — are reported. (You can detect overrange conditions from the bits returned in base 
unit format.) Overrange errors and pacing errors are discussed in more detail later in this chapter. 

Multiple Configurations 

The Measurement Library allows you to have up to 16 different ADC card configurations at any one 

time. Each configuration requires a separate call to Config 0, and each call specifies a unique name for 

a card. You can assign multiple names, and thus multiple configurations, to a single card if you wish. 
This would allow you to take readings from different voltage sources on different channels of the same 
card without reconfiguring the card all the time. For example, say you had flow meters connected to 
channels 1, 2, and 3 of the card and thermocouples connected to channels 4, 5, 6, and 7. You could 
specify one name for a flow meter configuration and another name for a thermocouple configuration: 
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180 Config 0("Flow","98640A",18,1 , .01 ."NoV'User", 12.5,-12.5) 
190 Config~0("Thern>o","98640A", 18, 64,. 01, "No", "Standard") 



When you want to take a reading from either type of voltage source, just specify the name of the 
appropriate configuration in your reading call: 



420 Input ("Thermo", 5,Tvolt) 
430 Input ("Flow", 2, Gpm) 



If 16 different ADC configurations are not enough for your application, you can get more by re-using 
existing names. Do this by making a call to Config__0 and specifying an existing name; the old 
configuration parameters for that name will be erased and the new parameters (or their default values) 
will replace them. You will then have to re -initialize the name with a call to the Init subroutine before 
you can use the new configuration. 

Note that the use of different names for the same ADC card will not work in interrupt mode. DO NOT 
ATTEMPT TO ACCESS AN ADC BY A DIFFERENT NAME DURING INTERRUPT MODE DATA 
TRANSFERS. 



Taking Readings 

Taking readings is the whole reason for having an ADC card. Now that you've got your system 
configured, it's time to start taking those readings. All readings from the ADC card are taken by three 
subroutines: Input/Read channel, Sequential scan, and Random scan. Here's how you use them: 

Input/read channel Use the Input or Read channel subroutine for taking a single reading from a 

channel on the ADC card. Optionally, you can specify a gain and a pace interval in the subroutine call. 

A call to Input would look like this in BASIC: 

340 Input ("ADC", Chan, Volts) 
The analogous call to Read channel would look like this in Pascal: 

read_channel( 'ADC', chan, volts, gain, pace) ; 

Input is the name of the routine as used in a BASIC program; in a Pascal program, use Read channel. 

Input was chosen for BASIC for compatibility with the HP 14751 A software. Note that you must be 
very specific when you call the Input subroutine: the I must be upper case and all the other letters must 
be lower case; otherwise there will be a conflict with the BASIC keyword INPUT. The name Input 

doesnt work at all with Pascal (another keyword conflict), so Read channel was chosen instead. 

Whatever the name, the subroutine works the same way in either language. 
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Note that if you specify the optional parameters for gain and/or pace interval, they override the 
existing values only for the duration of the subroutine call. After the call has completed, the gain and 
pace interval parameters revert to their previous values. 

The operation of the Input subroutine in interrupt mode is different from its normal operation. Refer 
to the discussion of interrupt mode, later in this section, for more details. 

Sequential scan. Use the Sequential scan subroutine to take readings on all channels in sequence 

from a starting channel to an ending channel. These readings are all taken at the same pace rate (which 

you specify) and the same gain (specified by the most recent call to Config or Set__gain), and the 

values are returned to a data array. Optionally, you can repeat the readings as many times as you want. 
For example, if you wanted to take readings from channels 2 through 7 on an ADC card, at the same 
gain and pace rate, Sequential scan would be the appropriate subroutine to use. In BASIC: 



100 INTEGER Start, Stop, Repeat 
110 REAL Data(1:6) 



230 


Name$="ADC" 


240 


Start =2 


250 


Stop=7 


260 


Pace =0.01 


270 


Rept*1 



460 Sequent ial_8can(Name$, Start , Stop, Pace, Data (*) ,Rept) 



In Pascal: 



CONST name ■ 'ADC'; 
pace = 0.01 ; 
start « 2; 
stop « 7; 
rept * 1 
d size » 6; 



TYPE d_array = ARRAY [1..6] OF real; 
d_ptr * ~d_array; 

VAR data: d_ptr; 



new(data); 

sequent ial_scan (name, start, stop, pace ,d_size, data, rept); 
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You must make sure that your data array is large enough to hold all of the readings that the 

Sequential scan call will generate. Note that if the call to Sequential scan aborts, the contents of the 

array will be undefined. (This is because the Sequential scan subroutine uses the array space as 

temporary storage for a variety of nasty, messy variables; it doesn't fill the array with nice, clean data 
until just before it returns to your program. If the subroutine aborts while the array space is filled with 
garbage and your program tries to interpret the garbage as data, you may not be pleased with the 
results.) 

The pace interval that you specify when you call Sequential scan will be maintained only for the 

duration of that call. After the readings have been taken, the pace interval will revert to its previous 
value. 

Random scan. Use Random scan when you need lots of flexibility. Random scan lets you read 

from the channels on a card in any order, and you can assign an individual pace interval and gain for 
each reading. Additionally, you can repeat the set of readings as many times as you want. 

The readings are controlled by a set of arrays. A channel array lists the order of the channels to be 
read. A gain array lists the gains for the readings. A pace array lists the pace intervals that will elapse 
between readings. And a data array stores the results. The sizes of the channel, pace, and gain arrays 

need not be the same. The Random scan subroutine simply starts at the beginning of each array and 

uses the values in sequence. After Random scan uses the last element in an array, it goes back to the 

beginning of the array for the next value. (Note that the gain and pace values do not start over just 
because the channel array repeats. ) 

For example, consider an ADC card that has flowmeters attached to channels 2, 3, 4, and 5, and 
thermocouples attached to channels 6 and 7. Say that you wanted to take the following sets of 
readings: 



Channel 


2 


3 


6 


4 


5 


7 


Pace 


.02 


.02 


.02 


.02 


.02 


.02 


Gain 


1 


1 


64 


1 


1 


64 



To take these readings, you could set up the following arrays: 

Channel 2 3 6 4 5 7 

Pace . 02 

Gain 1 1 64 
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In taking readings from the channels in the channel array, the Random scan subroutine will use the 

pace array six times and the gain array twice. The call sequence to take those readings once would be, 
in BASIC: 



110 INTEGER Channel(1:6) 

120 REAL Pace(lrl) 

130 INTEGER Gain(1:3) 

140 REAL Data(1:6) 

150 DATA 2,3,4,5,6,7 

160 READ Channel (*) 

170 DATA .02 

180 READ Pace(«) 

190 DATA 1,1,64 

200 READ Gain(«) 



320 Re peat =1 

330 Random_8can ("ADC", Channel (♦), Data (*), Repeat, Pace (*)» Gain (•)) 
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In Pascal the sequence would be: 



CONST name - 'ADC'; 
start = 2; 
etop = 7; 
rept * 1 ; 
d_size = 6; 
p_size = 1 ; 
gsize ■ 3; 
c_size = 6; 

TYPE r_array = ARRAY [1..6] OF real; 
r_ptr = *r_array; 
i array = ARRAY [1..6] OF ahortint; 



VAR 



ijatr 



i_array; 



data: r_ptr; 
channel: i_ptr; 
pace: r_ptr; 
gain: i__ptr; 



2; 
3; 
4; 
5; 
6; 
7; 



= 0.02; 



new(channel); 
channel"[1) 
channel^ [2] 
channel^ [3] 
channel~[4j 
channel^[5] 
channel*[6J 
new(pace) ; 
pace~ [ 1 ] 
new (gain) 
gain~[1] := 1; 
gain-[2] := 1; 
gain~[3] := 64; 

new(data); 

random_scan (name, 

c_eize, channel, 

d_size,data, 

rept, 

p__eize,pace, 

g_size,gain); 
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In the general case, the ith reading is taken using the following array elements: 

Channel: chan_array [i mod size__of (chan_array)] 

Pace: pace__array [i mod size__of (pace_array) J 

Gain: gain array [i mod size_of (gain_array)] 

Data: dataTi] 

Make sure that the data array is large enough to hold all of the readings that will be generated by the 

Random scan call. (Don't forget to account for repeats.) As with Sequential scan, if the call to 

Random scan aborts, the contents of the array will be undefined. 

The channel, pace, and gain arrays must be dimensioned as arrays, even if they are only single -valued. 
Scalar variables can not be used. 

The pace and gain values specified in Random scan are used only for the duration of the 

Random scan call. After the readings have been taken, pace and gain revert to their previous values. 

The Pipeline 

The ADC requires three operations to produce a reading: 

1 ) provide the channel address for the reading 

2) latch the voltage and convert it to a digital value 

3) return the value to the host computer 

For any given reading, these three operations must be done serially: 

+ + + + 

| add re 8 s | convert | return | 

+ + + + 

time > 

Figure 1-1. Analog input operation 
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However, to maximize throughput, the ADC card "pipelines" the readings. That is, while the value for one 
reading is being returned, the voltage for the next reading is being latched and converted, and the channel 
address is being provided for the reading after that For example, during time period t3 in the figure 
below the first reading is taken from the card while the second reading is being converted and the third 
address is being supplied. 

C i S J «■ ■ *. ij "-- i " i; !■ 

i '. ' n - ". t- i -=j %> 

I address 1 | convert 1 |~ff«tufn ,1 '; | 

I address 2 |:';:«6hv^rt 2 I return 2 | 

h!iddresa!,i3 | convert 3 | return 3 | 

•f lir nr'iit «r » «« «♦ — TM. *t •+. + — _______-__+_________ __^._ ________ _^. 



yiSiiSii!: 



address 4 | convert 4 | return 4 | 



j3» !!. , |i 

ti t2 f^ii-iS'i i i';:: 1 t4 ts t6 

I! ' "i- if.H- B3nli 1 1 iiTi. hi 

time > 

Figure 1-2. Analog Input Pipeline 

To start the flow of readings, the Measurement Library software primes the pipeline by taking two 
"garbage" readings (at times tl and t2 in the figure above); these two readings are thrown away. (Their 
only purpose was to start pulling valid readings through the pipeline.) The third reading taken is the first 
valid reading, since it is the first reading that has gone through all three stages of the pipeline; it is 
written into the data array as the first reading. 

For all readings taken in normal mode, the Measurement Library software takes care of priming and 
emptying the pipeline; it does this by taking two more readings than are requested and throwing away the 
two extra garbage values. This happens for each subroutine call; you never have to pay any attention to 
it, since the software takes care of it all. 

(Note that since each subroutine call incurs the extra time required for two readings, it is difficult (if not 
impossible) to maintain accurate and even pacing of readings between one subroutine call and the next. If 
your application requires accurate pacing for a block of readings, we suggest that you make all of those 

readings with one subroutine call. Use Sequential scan or Random scan, as appropriate to your 

application.) 

For readings taken in interrupt mode, the Measurement Library software does not take care of the 
pipeline for you. You must keep track of which readings are which (not a very taxing operation) and 
throw out the garbage. More information on interrupt mode programming is contained later in this 
section. 



Overrange Errors 

You can encounter two kinds of overrange conditions with the ADC card: normal mode overrange and 
common mode overrange. Normal mode overrange occurs when the input voltage exceeds the range of 
the analog-to-digital converter. Common mode overrange occurs when either side of the differential 
input voltage exceeds the maximum input voltage of its input amplifier. The next several paragraphs 
explain how these overrange conditions can affect your readings. 
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The voltage measured by the ADC card is the differential input voltage between the + Input and - Input 
terminals of a channel on the card. The two sides of the input signal pass through separate input 
amplifiers (op amps), and are then sent to an analog-to-digital (A-to-D) converter for conversion to a 
numeric value. (The figures below show this circuit configured for a gain of 1.) 

There are a couple of limitations that apply to this measurement circuit: 

1 ) The voltage output from an input op amp can not exceed ±10 volts, relative to system ground. For a 
gain of 1, this also means that the input voltage applied to the op amp can not exceed ±10 volts, 
again relative to system ground. (The situation gets rather more complicated for gains greater than 
one; the formula for figuring the maximum input voltage is somewhat abstruse, involving various 
voltages, gains, and a couple of 2s. We won't get into the mathematics of it, but figure 1-6 shows an 
example of the results that you may see.) Exceeding this input limit causes a common mode 
overrange: the output of the op amp is clipped at its limit (+10 volts or - 1 volts) and the overrange 
flag (the O bit in a base unit reading) is set to 1. 

2) The A-to-D converter, which compares the outputs of the op amps, can not measure a difference of 
more than 10 volts. If the difference between those outputs is more than 10 volts, the A-to-D 
converter clips its output value to 1 volts; this situation is defined as a normal mode overrange. 

The next few figures show various combinations of input voltages and the outputs they produce. In the 
figures, + Input and - Input voltages (relative to system ground) are shown in "stick" type, like this: 

+ 4 

The differential input voltages are shown in Roman type, like this: 

+6 

Figure 1-3 shows a typical reading that causes no problems. The input voltages propagate through the 
op amps with no clipping, the differential voltage is well within the range of the A-to-D converter, and 
the converter comes up with the correct value. 



+4 




+4 



+6 



+6 



-2 




-2 



A-to-D 
Converter 



+6 



Figure 1-3. Reading OK 
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Figure 1-4 shows a normal mode overrange condition. The + Input and - Input voltages are within the 
range of their respective op amps, but the differential input voltage (+12 volts) is too great for the 
A-to-D converter. The result is a normal mode overrange condition, yielding a full -scale (and 
incorrect) reading from the A-to-D converter. 



+6 




+6 



+ 12 



+ 12 



-6 




-6 



A-to-D 
Converter 



+ 10 



Figure 1-4. Normal mode overrange 

Figure 1-5 shows a common mode overrange condition. The + Input voltage of +12 volts is clipped to 
+10 volts and the overrange flag (O bit) is set to 1. The differential voltage presented to the A-to-D 
converter is within the range of the converter, so it converts the voltage correctly and comes up with 
the wrong answer. 



+ 13- 




+ 10 



+4 



+2 



+8 




+8 



A-to-D 
Converter 



+2 



Figure 1-5. Common mode overrange 
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Figure 1-6 shows a subtler form of common mode overrange that you may encounter at gains greater 
than 1. This is because the programmable gain amplifier amplifies the difference between the + Input 
and - Input voltages before sending the result to the A-to-D converter. Even though the input 
voltages appear to be acceptable, the amplifier may try to boost them out of the acceptable range. In 
this case, the programmable gain circuit tries to boost the + Input voltage to 11.5 volts, but the output 
limit of the op amp keeps the voltage from exceeding + 1 volts. The overrange flag (O bit) is set to one 
and the clipped voltage is sent to the A-to-D converter. The resulting value is incorrect. 



+8 




+ 10 

tlKL 



+1 



+6.5 



+7 




A-to-D 
Converter 



+6.6 



+3.5 



Gain = 8 



Figure 1-6. Common mode overrange at gain greater than 1 



A normal mode overrange is indicated when a reading returns the maximum possible magnitude value. 
(This is the same as "clipping".) The maximum magnitude value depends on the units in use, as follows: 

Base: 4095 (all D bits set to 1) 

Standard: (4095 * lsb - calibrate) / gain 

User: ((4095 * lsb - calibrate) / gain) * mulitplier + offset 

where: lsb - 10 / 4095 volts/bit 

Note that it is not possible to tell the difference between a full scale reading and a normal mode 
overrange reading. 

By default, a normal mode overrange condition does not generate an error. However, by setting a 

parameter in the Config call you can cause an error to be generated when a normal mode overrange 

occurs. 

Common mode overranges are harder to detect than normal mode overranges, since the value of the 
reading may appear to be correct even though an overrange has occurred. For this reason, common mode 
overranges are trapped as errors. 

Note that the Measurement Library reports errors for normal mode and common mode overranges only 
when you are operating in standard or user units. If you are operating in base units, no error will be 
reported. To detect a normal mode overrange in base units, check the D bits for a full scale reading; to 
detect a common mode overrange, check the O bit. 
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Pacing Errors 



The pace counter on the ADC card is used to determine the duration of the sample portion of the sample 
and hold cycle. The hold portion is always 9 microseconds, and the minimum sample portion is 9 
microseconds. The Measurement Library lets you specify a pace interval that is the sum of these two time 
periods. Thus you can set the pace at which readings are taken for ease in making accurate time domain 
measurements of time -varying quantities. 

If, due to outside factors (concurrent I/O transfers, keyboard interrupts, and so on), the Measurement 
Library software is unable to read from the ADC card fast enough to keep up with a programmed pace 
time, a pacing error will occur. This gives you the assurance that, in the absence of such errors, the time 
domain measurements are being accurately paced. 

While the ADC card and the Measurement Library are fully capable of taking readings every 18 
microseconds, the variable gain input amplifiers on the card are not capable of slewing from maximum 
positive to maximum negative during the 9 microsecond sample period that this pace rate requires. This 
puts an upper limit on the signal frequency component that the ADC can measure accurately at the 1 8 
microsecond sample rate. The following table shows that maximum frequency component for each gain, 
for readings to within 1 lsb on a single channel. 

Maximum Signal 
Gain Frequency Component 



1 


27 kHz 


8 


27 kHz 


64 


15 kHz 


512 


3.5 kHz 



When more than one channel is being sampled (as in Sequential scan and Random. 

speed of accurate sampling by the ADC is limited as follows: 



scan operations) the 



Gain 



Minimum Pace Time for 
Multichannel Scans 



Equivalent Maximum 
Sampling Speed 



1 50 microseconds 

8 50 microseconds 

64 71 microseconds 

512 1000 microseconds 



20000 readings per second 

20000 readings per second 

14000 readings per second 

1000 readings per second 



Interrupt Mode 

Interrupt mode operation is supported only in the BASIC language system. (It is NOT supported in 
Pascal.) Interrupt mode is useful when you want your program to continue execution between readings 
and still maintain an accurate or externally controlled pace rate. There are two subroutines associated 

specifically with interrupt mode: Enable intr and Disable intr. Appropriately enough, interrupt mode 

is enabled by a call to Enable_intr and is disabled by a call to Disable intr. 
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Only a limited subset of Measurement Library subroutine calls are allowed after you have entered 
interrupt mode: 

Input 

Config_0 

Init 

System init 

Disable intr 

Use of any other Measurement Library calls in interrupt mode will result in an error. 

When you are in interrupt mode, the Measurement Library does not automatically take care of setting up 
and clearing out the input pipeline. (Refer to the description of the analog input pipeline earlier in this 
section.) Thus, when you take a reading with the Input subroutine, the result you get is the value of the 
reading taken two readings ago. You should discard the data returned from the first two Input calls. 

Interrupt mode does not handle multiple configurations of the same card cleanly. To avoid taking 
erroneous readings, do not take readings from different configurations (names) for the same card while in 
interrupt mode. 

The shortest recommended pacing interval in interrupt mode is 36 milliseconds. This is very close to the 
longest pacing interval available from the ADC card (39. 3336 milliseconds). You can get longer pacing 
intervals by using external pacing. (External pacing is discussed later in this section. ) 

The following example shows a BASIC program that takes readings in interrupt mode. Its purpose is to 
take 8 voltage readings; to do that it takes 1 readings and ignores the first 2 (invalid) readings. 



40 REAL Volts (-1:8) 

50 1=2 

110 ConfigJ)( ,, ADC , \ , '98640A , \ 18,1,. 036) 

120 Init( M ADC M ) 

130 EnableJntrC'ADC") 

140 ON INTR 18 GOSUB Service 

150 Input ("ADC", 5,Volts(-1)) 

340 Service: ? 

350 Input CADC",5,Volts(I-2)) 

360 1=1+1 

370 IF I>10 THEN 

380 OFF INTR 18 

390 Disable^intrC'ADC") 

400 PRINT Volts (1:8) 

410 STOP 

420 END IF 

430 RETURN 

440 END 

Note that the order of the Enable__intr call and the ON INTR statement is not critical. Enable intr 

does not physically enable interrupts on the ADC card; it only sets flags in the Measurement Library. The 
card interrupts are physically enabled by the first Input call after Enable intr (line 1 SO in this example). 
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External Pacing 

You might use external pacing for ADC readings if: 

— you want to use a pace interval longer than that allowed by the Measurement Library software 
(0.0393336 second) 

— you want the readings to be controlled by an external event, rather than by time 

External pacing is primarily a hardware operation. It is largely controlled by two hardware control lines, 
IPACDA (internal pace disable) and EPCON (external pace control). There's not a lot of software 
involvement, other than making the read requests that you would normally make for an internally paced 
read. The timing of the execution of those read requests is controlled by the hardware. (There's no 
provision in the software for controlling IPACDA and EPCON directly; you'll have to build your own 
circuits to control them. ) 

In the next several paragraphs we will look at some of the features of the hardware and software that 
affect external pacing, and then we will see how they fit together in external pacing applications. In this 
manual well limit our discussion of the hardware to telling you when the IPACDA and EPCON control 
lines must be set low or high; we won't give you instructions for building the circuits that control those 
lines. You can, however, get more information about those control lines from the ADC hardware manual, 
part number 98640-90001. 

Hardware Considerations 

There are two control lines of interest for external pacing: 

IPACDA determines whether the readings are paced by the internal pacing timer on the ADC card. If 
IPACDA is low, the internal pacing timer of the card is used; if IPACDA is high, the internal pacing 
timer is bypassed and readings are taken at the free run speed of the card (one reading every 18 
microseconds). Note that IPACDA must be high when readings start in order for the timing of the first 
reading of a series to be accurately known. (IPACDA can be set low after the start of readings if you 
want the readings to be paced by the internal pacing timer.) 

EPCON controls whether or not any readings are taken. If EPCON is low, readings are taken whenever 
they are requested. If EPCON is high, requested readings are held off; a read request will not complete 
until EPCON goes low again. 

In summary, when EPCON is low, readings are taken at the free run speed of the card (if IPACDA is high) 
or at the time programmed into the internal pacing timer (if IPACDA is low). When EPCON is high, 
readings stop. 

Software Considerations 

When making externally paced readings, you will have to allow for the software set-up time of the 
various subroutines. The set-up times in the BASIC language for the reading subroutines are: 

Input 2*0 milliseconds 

Sequent ial_scan 3.5 milliseconds + 0.1 milliseconds per reading 
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Random_8can 3.0 milliseconds +0.4 milliseconds per reading 

You can use these set-up times for Pascal programming as well. Pascal set-up times are shorter than 
those in BASIC, so the times listed above will give you plenty of margin in your Pascal applications. 

Applications 

External pacing applications divide into two general types: single readings and bursts of readings. 

Single readings. The idea behind taking single externally paced readings is that you keep EPCON high 
until you want to take a reading, set it low only long enough to take the reading, and then set it high 
again. The steps in taking a single reading are: 

1) Set IPACDA high. IPACDA will remain high for the duration of externally paced readings. 

2) Set EPCON high. This holds off all readings. 

3) Issue a call to Input/read channel, Sequential scan, or Random scan. 

4) Wait The length of time you wait should be at least the set-up time. 

5) When it is time to take a reading, set EPCON low. Keep it low for 1 to 1 5 microseconds, then set it 
high again. This will allow one (and only one) reading to be taken. 

6) Repeat step 5 until you have taken all the readings that you requested with the subroutine call in 
step 3. The subroutine will return to your application program only after all requested readings have 
been taken. 

As indicated in step 4, each subroutine call you make requires that you wait the set-up time before 

pulsing the EPCON line to take the first reading. For Input (or Read channel) calls made in normal 

mode, that means that you must wait the set-up time before each reading. If you're using Input in 
interrupt mode, the set-up time is required only before the first reading. Keep in mind, however, that the 
EPCON pulses should be at least 36 milliseconds apart if you're operating in interrupt mode. 

Bursts of Readings. The idea behind taking readings in bursts is that you request multiple readings with 
a subroutine call, and then take those readings in one burst by setting EPCON low until all of the readings 
have been taken. These readings can be taken at the free run speed of the card, or they can be paced by 
the card's internal pacing timer. The following steps are for triggering burst readings that are paced by 
the internal pacing timer. 

1 ) Set IPACDA and EPCON high. 

2) Make a read request by issuing a call to Sequential scan or Random scan. 

3) Wait. You should wait for at least the set-up time plus the pace interval. 

4) Set the EPCON line low. The analog -to -digital conversion for the first reading will start in 
approximately 3 microseconds. 

5) Set the IPACDA line low. This must happen 1 to 1 5 microseconds after you set EPCON low. 

6) Hold EPCON and IPACDA low until all of the requested readings have been taken. (The subroutine 
call will return to your application program after all of the readings have completed. ) 
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The requirement (in step 3) that you wait the set-up time plus the pace interval assures that the first 
reading occurs at a more -or -less known time (within approximately 3 microseconds after EPCON is set 
low), and that the voltage has been sampled for at least the prescribed sample time (pace interval minus 9 
microseconds). 

Combinations. You can combine the above two methods of external pacing if your application requires. 
We won't go into those combinations here; we leave that as an exercise for the interested reader. The 
methods above should give you enough information to make your combination work. 
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SECTION 



This section gives the subroutine call syntax for the subroutines in the HP 98645A Measurement Library. 
The subroutine calls supported by the library are: 

Calibrate ** 
Config_0 ** 

Disable intr 

Enable intr * 

Init 
Input * 

Meas_lib init ** 

Random_scan * 

Read channel 

Sequential scan 

Set_gain** 
Set_units ** 
System init 

* These calls incorporate optional extensions beyond the. HP 14751 A Computer Aided Test 
Programming Package for the Model 6 9 44 A). 

** These calls do not exist in the HP 147 51 A package. 

In the following subroutine descriptions, these conventions apply: 

— The parameters list for the subroutine appears in parentheses: ( ). These parentheses must be 
included in the subroutine calL 

— Optional parameters (BASIC only) are contained within square brackets: [ ]. 

String parameters for name and model number are case sensitive. (That is, don't use lower case characters 
in place of upper case, and vice versa. ) All other string parameters are case insensitive. 

Note that none of the parameters in Pascal calls are optional. 

Pascal data types exported by the Measurement Library are as follows: 

TYPE shortint = -32768. .32767; 
byte « 0. .255; 
8tr255 = string[255]; 

iarraytype « ARRAY [0. .max int] OF shortint; 
rarraytype = ARRAY [0. .max int] OF real; 
rarraypt - "rarraytype; 
iarraypt = "iarraytype; 

The remainder of this section gives the subroutine call syntax, arranged by subroutine in alphabetical 
order. Note that parameters identified as INTEGER are of type INTEGER in BASIC, but of type shortint 
in Pascal. 
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Calibrate allows you to measure and compensate for the various offsets in the ADC card. To do this, 
Calibrate dedicates one channel on the card to making reference readings; the offsets derived from the 
reference readings are used to adjust the readings taken on the remaining channels of the card. 

Syntax 

BASIC: Calibrate (name, channel, pace, number) 

Pascal: PROCEDURE calibrate (name: str255; 

channel: shortint; 
pace: real; 
number: shortint); 

Parameters 

name: a string or string literal specifying the ADC name from the 
Config_0 call. 

channel: an INTEGER specifying the reference channel (from to 7) to 
be used for calibration. 

pace: a REAL number specifying the calibration pace rate, from 
0.000018 to 0.0393336 seconds with a resolution of 600 
nanoseconds. 

number: an INTEGER specifying the number of readings to be taken for 
this calibration. This number must be from 1 to 32767. 



Discussion 

To use the calibration feature, you must first short the + Input and - Input terminals of one of the 
channels on the card to card ground; this gives a volt input for that channel. Then you specify that 
channel in the call to the Calibrate subroutine. When the Calibrate call is executed, the specified number 
of readings are taken at all gain settings, and the average for each gain setting is saved. The offsets are 
then used to calculate the proper correction values for positive and negative readings at each gain. When 
subsequent readings are taken on other channels, the correction value is subtracted from the reading prior 
to conversion to standard or user units. (No correction is applied to a reading expressed in base units. ) 

Note that occasionally a Calibrate call will abort with an error 860. This may be caused by temporary 
transient electrical noise, especially on calibration calls with small numbers of readings. 860 errors from 
Calibrate calls should routinely be re-tried several times, and the connections of the shorting wires at the 
calibration channel checked, before you assume that the ADC card is defective. 

Note that Calibrate temporarily requires 8 bytes of memory for each reading specified in the number 
parameter. Large numbers of readings may cause errors due to not enough memory. 
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Config_0 sets up an HP 98640A ADC card for access by the Measurement Library subroutines- 



Syntax 



BASIC: 



Pascal: 



Conf ig_0( name, model [, select code[,gain[, 
pace [ , report_error]]\un its [ , 
multiplier!, offset] ]]]]]]) 

PROCEDURE conf ig_0 (name: str255; 

model: str255; 
select_code: shortint; 
gain: shortint; 
pace: real; 
report_error: str255; 
units: str255; 
multiplier: real; 
offset: real); 



Parameters 

name 

model: 
select_code 

gain: 
pace: 



a string or string literal specifying the name used by the 
Measurement Library software to refer to a particular ADC 
configuration. 

a string or string literal identifying the ADC card model 
number ("98640A"). 

an INTEGER giving the physical select code (address) of the 
ADC card. This number is between 8 and 31, and is set by 
hardware switches on the card (SW1 , switches 1 through 5). 



an INTEGER specifying the default ADC hardware gain, 
value must be 1, 8, 64, or 512. 



The 



a REAL number defining the default pace time loaded into the 
pace counter. This value can be from 0.000018 to 0.0393336 
seconds, with a resolution of 600 nanoseconds. 

a string or string literal enabling an error condition on 
normal mode overrange readings. The value can be either yes 
or no. (Only the first character is significant; only "y" 
and "Y" are taken as yes, all others indicate no.) 

a string or string literal specifying the units to used to 
return ADC data. The units can be base, standard, or user. 
(Only the first character is significant.) 

base = binary data read directly from the ADC 
standard « (base • ADClsb - calibrate) / gain 
user « standard * multiplier + offset 

multiplier: a REAL number specifying the multiplier used with user units. 



report_error: 



units 
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offset: a REAL number specifying the offset used with user units. 

Default values: 

select_code 18 

gain 1 

pace .001 second 

report__error no 

units standard 

multiplier 1.0 

offset 0.0 

Discussion 

Config establishes a link between a name (which you supply) and an ADC card, and specifies operating 

parameters for that name and card. Each ADC card used must be configured with a unique name. You 
can configure the same card with several different names and parameter sets, and everything will work 
except interrupt mode data transfers. DO NOT ATTEMPT TO ACCESS AN ADC BY ANOTHER NAME 
DURING INTERRUPT MODE DATA TRANSFERS. 

A maximum of 1 6 names may be configured into the Measurement Library software. If you need more 
configurations, names may be re-used. If a name is identical to an already used name, all configuration 
parameters for the old name will be erased and the new configuration parameters or defaults will be used. 
The name will then have to be reinitialized with Init before it is accessed. 

All readings taken by the ADC are reported in one of three reporting units: base, standard, or user. Base 
units are in the form of a 1 6-bit binary integer, with the following format: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 
+ + + + + + + + + + + + — + + + + + 

|B|W|0|S|D|D|-D|D|D|D|D|D|D|D|D|D| 
+ + + + + + + + + + + + +---+ + + + 

MSB LSB 

where: 

B ■ BUSY. If bit 15= 1, the ADC is busy. The reading is not taken and all other bits are invalid. If bit 
1 5 * 0, a valid reading is returned. 

W ■ WAIT. If bit 14 » 1, the ADC card was in the wait state at the time of the reading. This means 
that the card was not read within the interval specified in the pacing timer — that is, a paced read 
was not made at the correct time. (You should never see this bit set, since the ADC Library software 
reports an incorrectly paced read as an error and will not return a value for the reading. ) 

O • OVERRANGE. If bit 1 3 ■ 0, a common mode overrange condition occurred during this reading, 
and the reading is invalid. If bit 13 s 1, no common mode overrange condition occurred during this 
reading. Note that the sense of this bit is negative true. 

S * SIGN. If bit 12- 0, the value returned for the reading is positive. If bit 12- 1, the value returned 
for the reading is negative. 
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D * DATA. The data bits give the 1 2-bit binary magnitude of the voltage read from the ADC (The 
sign of the voltage is given by the S bit, bit 1 2.) 

MSB * most significant bit. 

LSB * least significant bit 

Base unit readings are raw readings; no gain factors or calibration corrections are applied. 

The value used by the Measurement Library for the ADC card least significant bit (ADClsb) is the 64-bit 
floating point value of 

10 volts/ 4095 bits 
or 

X 442002442002442 millivolts per bit 
The least significant bit (LSB) values used in each gain range are: 

LSB - ADClsb / gain 

Thus, the approximate LSB values in each gain range are: 

Gain LSB 

1 2.4420 millivolts 

8 305.25 microvolts 

64 38.156 microvolts 

512 4.7695 microvolts 

Standard units are real numbers representing true volts. They are equivalent to base unit values corrected 
for gain and calibration (if any). User units are real numbers equivalent to standard units times a 
multiplier plus an offset. 

ADC readings are always returned from the Measurement Library calls as real numbers or real array 
elements (IEEE 64 bit floating point binary representation in both BASIC and Pascal). Readings in 
standard or user units should be stored and manipulated as real numbers. Readings in base units must be 
converted into integer format by the user program prior to any manipulation of the data. Assignment to 
an integer variable in BASIC, or using the trunc or round function in Pascal, will suffice. 

Refer to "Setting Up" in Section 1 of this manual for a full discussion of ADC card configuration. 
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Disable intr configures the ADC card for normal, non -interrupt mode operation. 

Syntax 

BASIC: Disable_intr(name) 
Pascal: PROCEDURE disable intr(name: str255); 



Parameter 



name: a string or string literal specifying the ADC name assigned 
by the Config_0 call. 



Discussion 

Interrupt mode operation is supported only for BASIC environments. Use of interrupt mode in Pascal is 

not supported. Please refer to the discussion of the Enable intr subroutine (next page) for further 

information. 
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Enable intr configures an ADC card for interrupt mode operation. 

Syntax 

BASIC: Enable_intr(name) 
Pascal: PROCEDURE enable intr(name: str255); 



Parameter 



name: a string or string literal specifying the ADC name assigned 
by the Config call. 



Discussion 

Interrupt mode operation is not supported in the Pascal environment. (That means you're on your own if 
you use it. If you have trouble making it work, you can purchase HP consulting, on a time and materials 
basis, from your local HP sales and service office. HP sales and service offices are listed in the back of this 
manual.) For interrupt mode to work in Pascal, you need to have an appropriate interrupt service routine 
(ISR). If you use interrupt mode without one, you will probably crash your system. We don't provide an 
ISR as part of the Measurement Library, but if you're a skilled Pascal programmer you may be able to 
write one of your own. Refer to the Pascal 2. System Designer's Guide, part number 09826-90074, for 
more information on ISRs. 

Interrupt mode does work in BASIC. There are a few things you should be aware of: 

1) The only Measurement Library calls allowed after an Enable interrupt call are: 

Input 

Config_0 

Init 

System init 

Disable interrupt 

2) The Input subroutine functions differently in interrupt mode. Refer to the description of that 
subroutine later in this section for more information. 

3) Interrupt mode does not handle multiple configurations of the same ADC card well. To prevent 
erroneous readings, do not try to take readings from different configurations (names) of the same 
ADC card while in interrupt mode. 

For a more complete explanation of interrupt mode programming, refer to Section 1 of this manual. 
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Init resets and disables interrupt mode on an ADC card, and sets the calibration array to its default 
values. 

Syntax 

BASIC: Init (name) 
Pascal: PROCEDURE init (name: str255); 

Parameter 

name: a string or string literal specifying an ADC name assigned by 
the Config__0 call. 



Discussion 

The Init (initialize) call must be used prior to any other calls except Conf ig and System init. A single 

call to System init may be substituted for individual Init calls for all currently configured cards. 



2-8 



INPUT 



The Input or Read channel subroutine takes one reading from a specified channel on an ADC card. 

Input is used in BASIC programs; Read channel is used in Pascal programs. 

Syntax 

BASIC: Input (name, channel, datum [,ga in [ , pace] ] ) 

Pascal: PROCEDURE read_channel(name: str255; 

channel: short int; 
VAR datum: real; 
gain: shortint; 
pace: real); 



Parameters 

name : 

channel: 

datum: 
gain: 

pace: 



a string or string literal specifying an ADC name assigned by 
the Config_0 call. 

an INTEGER specifying the channel number (from to 7) to be 
read . 

a REAL variable to hold the value of a reading. 

an INTEGER specifying the hardware gain. The value must be 
1, 8, 64, or 512. If a value is not given for the gain, the 
value specified in a Config_0 or Set_gain call is used. 

a REAL variable specifying the pace interval that elapses 
before the reading. This value must be from 0.000016 to 
0.0393336 seconds, with a resolution of 600 nanoseconds. 



Discussion 

The reading returned by a call to Input or Read channel will be formatted according to the units 

specified in a previous call to Config or Set units. If you specify values for gain or pace, those values 

will be used only for the duration of this Input (Read__channel) calL 

The Input subroutine operates differently in interrupt mode. This involves the analog input pipeline. 
(Section 1 of this manual has more information on the pipeline.) For any reading, it takes 3 read 
operations to get that reading all the way through the pipeline. In normal mode, the Input subroutine 
performs all 3 of these readings and returns the 1 valid reading. In interrupt mode, Input performs only 1 
read operation and returns the value that was requested two operations before; it is up to your program to 
keep track of the progress of your readings through the pipeline. (For more information on interrupt 
mode programming, refer to Section 1 of this manual.) 

Be careful of how you call the Input subroutine from BASIC: use "Input" (not "INPUT" or "input") to avoid 
conflict with the BASIC keyword "INPUT'. In Pascal, use "Read__channel". 

The pace interval comprises the sample time and the analog-to-digital conversion time for the reading. 
Conversion takes 9 microseconds; thus, the sample time is the pace time minus 9 microseconds. 
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Meas lib init initializes the global variables in the Measurement Library. In a BASIC environment, it 

also initializes the heap area. 

Syntax 

BASIC: Meas_lib_init 
Pascal: PROCEDURE meas_lib_init; 

Discussion 

Your application program must call Meas lib init before it calls any other Measurement Library 

subroutines. 
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RANDOM SCAN 



Random__scan takes readings from channels in any order that you specify, with whatever pace and gain 
value that you specify for each individual reading. 



Syntax 



BASIC: Random_scan(name,chan_array(*),data_array(*) [,rept[, 

pace_array(«) [,gain_array (*)]]]) 

Pascal: PROCEDURE random_s can (name: str255; 

chan_size: integer; 
chan_array: anyptr; 
data_size: integer; 
data_array: anyptr; 
rept: shortint; 
pace_size: integer; 
pace_array: anyptr; 
gain_size: integer; 
gain_array: anyptr); 



Parameters 

name: 

chan size: 



a string or string literal specifying the ADC name assigned 
by the Config_0 call. 

(Pascal only) an integer giving the size of the array of 
channel numbers 



chan_array: in BASIC, the name of an INTEGER array of channel numbers. 
In Pascal, this is a pointer to the shortint array of channel 
numbers. The channel numbers can range from to 7. 

data_size: (Pascal only) an integer giving the size of the array of 
readings. 

data__array: in BASIC, the name of a REAL array to hold readings from the 
ADC card. In Pascal, this is a pointer to the real array of 
readings. 

rept: an INTEGER number of times to scan the channel array. This 
number can be from 1 to 32767; the default value is 1. 

pace_8ize: (Pascal only) an integer giving the size of the array of pace 
interval values. Specify if you want to use the default 
pace value. 

pacejarray: in BASIC, the name of a REAL array of pace interval values. 
In Pascal, this is a pointer to the real array of pace 
interval values. The values in the array must be from 
0.000018 to 0.0393336 seconds, with a resolution of 600 
nanoseconds. The default pace value is the value specified 
in the Config_0 call. In Pascal, you must specify NIL if you 
want to use the default value. 
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gain_size: (Pascal only) an integer giving the size of the array of gain 
values. Specify if you want to use the default gain value. 

gain__array: in BASIC, the name of an INTEGER array of gain values. In 
Pascal, a pointer to the short int array of gain values. The 
gain values in the array must be 1, 8, 64, or 512. The 
default gain value is the value specified in the Config_0 or 
Set__gain call. In Pascal, specify NIL if you want to use the 
default value. 



Discussion 

The sizes of the channel, pace, and gain arrays need not be the same. The Random scan subroutine 

simply starts at the beginning of each array and uses the values in sequence. After Random scan uses 

the last value in an array, it goes back to the beginning of the array for the next value. (Gain and pace 
values do not start over just because the channel array repeats.) In the general case, the ith reading is 
taken using the following array elements: 

Channel: chan__array(i mod size_of (chan_array) ) 

Pace: pace_array(i mod size_of (pace__array) ) 

Cain: gain array (i mod size_of (gain_array)) 

Data: data?i) 

Note that the data array must be large enough to hold all of the readings that will be generated by the 
Random scan call (including repeats). 

Gain and pace values specified for a Random scan call are valid only for the duration of that call. 

After the call has completed, the gain and pace values revert to their default values. 

If you are programming in Pascal and you want to use the default pace interval value (the value that was 

specified in the Conf ig call for the card), you must specify a value of for the pace size parameter 

and a value of NIL for the pace array parameter. Similarly, if you want to use the default gain value, 

specify a value of for the gain__size parameter and a value of NIL for the gain array parameter. 

The channel, pace, and gain arrays must be dimensioned as arrays, even if they are only single-valued. 
Scalar variables can not be used. 
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READ__CHANNEL 

Read__channel is the Pascal equivalent of the Input subroutine. Refer to the discussion of Input earlier 
in this section for information on Read channel. 
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Sequential scan takes readings from sequential channels on an ADC card. 



Syntax 

BASIC: 
Pascal: 



Sequent ial_scan (name, start, stop, pace, data_array(*) [,rept] ) 

PROCEDURE sequent ial_s can (name: str255; 

start: shortint; 
stop: shortint; 
pace : rea 1 ; 
data_size: integer; 
data__array: anyptr; 
rept: shortint); 



Parameters 

name: 

start; 
stop: 

pace: 

data_size: 
data_array: 

rept: 



a string or string literal specifying the ADC name assigned 
by the ConfigJ) call. 

an INTEGER specifying the number of the first channel to be 
read. This number must be from to 7* 

an INTEGER specifying the number of the last channel to be 
read. This number must be from to 7 and must not be less 
than start. 

a REAL number specifying the pace interval. This interval 
must be from 0.000018 to 0.0393336 seconds, with a resolution 
of 600 nanoseconds. 

(Pascal only) an integer giving the size of the data array. 

in BASIC, the name of a REAL array to hold the readings taken 
from the ADC card. In Pascal, this is a pointer to the real 
array that holds the readings. 

an INTEGER giving the number of scans. This number must be 
from 1 to 32767; the default value is 1. 



Discussion 

Sequential scan scans (reads) the channels on the ADC card sequentially, from the start channel to the 

stop channel. You can repeat the scans as many times as you want (up to 32767 total scans). The data 
array must be large enough to hold the total number of readings (including repeats) that you request. 

One pace interval is used for all readings taken with the Sequential scan routine. This pace interval is 

valid only for the duration of the Sequential scan call; after this call has completed, the pace interval 

value reverts to the default value established with the Config call. 

The gain value used by Sequential scan is the default gain value set by the Config or Set gain call. 
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Set gain sets the hardware gain used in taking readings from the ADC card 
Syntax 

BASIC: Set_gain (name, gain) 

Pascal: PROCEDURE set_gain(name: str255; 

gain: short int); 



Parameters 



name : 



gain: 



a string or string literal specifying the ADC name assigned 
by the Config_0 call. 

an INTEGER specifying the gain to be used in making readings. 
The gain must have a value of 1, 8, 64, or 512. 



Discussion 

The gain set by the Set gain subroutine permanently overrides the gain set by a previous call to 

Conf ig__0 or Set gain. 

The description of the Config subroutine in this section discusses the lsb values for each gain setting. 



2-15 



SET UNITS 



Set units sets the reporting units for readings taken by the Measurement Library subroutines. These 

units are base, standard, or user units. 



Syntax 

BASIC: set_un its (name, units [ , multiplier^ , offset]] 

Pascal: PROCEDURE set__im its (name: str255; 

units: 8tr255; 
multiplier: real; 
offset: real); 



Parameters 

name: 

units: 

multiplier: 

offset : 



a string or string literal specifying the ADC name assigned 
by the Config_0 call. 

a string or string literal specifying the units to be used to 
return ADC data. The units must be base, standard, or user. 
(Only the first character is significant.) 

(user units only) a REAL number specifying the multiplier to 
be used. (See the discussion, below.) This parameter is not 
used with base or standard units. 

(user units only) a REAL number specifying the offset to be 
used. (See the discussion, below.) This parameter is not 
used with base or standard units. 



Discussion 

The three types of units are defined as: 

base = raw ADC reading returned as a binary integer 
standard s base unit reading adjusted for gain and calibration, 
expressed as a real number 
user ■ standard * multiplier + offset 

Set units permanently overrides any previous units specification made by a Config or Set units call. 

For more information on reporting units, see the description of the Config call in this section and the 

discussion of reporting units in Section 1 of this manual. 
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SYSTEM_INIT 

System init initializes all configured cards. For each card, it performs the same functions as the Init 

subroutine. 



Syntax 

BASIC: Syst«m_init 
Pascal: PROCEDURE systenMLnit; 
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MESSAGES 



APPENDIX 



The Measurement Library reports errors with the messages listed on the next page. The list gives the 
message number used, the meaning of the message, and the calls which can return the message. 

On the page after that are listed the Pascal -related error messages that may be returned to your BASIC 
program as a result of a Measurement Library subroutine call. 
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Messages 



Message 

Number 


Meaning 


801 


Unsupported Model 


804 


Array Too Small 


812 


Name Not Configured 


815 


Use of uninitialized name 


835 


Illegal select code 


837 


Specified card not at select 
code 


838 


Illegal name 


850 


Unsupported Gain 



Measurement Library Messages 

Reporting 
Calls 



851 Pace out of Range 



852 Repeat Specification Error 



853 Illegal Channel Number 



854 Not allowed in Interrupt Mode 



855 Common mode over range 



856 Normal ADC overrange (must be 
enabled by Conf ig_0) 

857 Pace timing error 



858 Unsupported units 

859 Max number of names exceeded 

860 Offsets out of range (card 
defective or calibration 
channel not shorted) 



Config__0 

Sequent ial_s can, Random_scan 

All except System_init and Config_0 

All except In it, System__init, and 
Config_0 ~~ 

Config_0 

Init 

Config_0 

Input, Random_scan, Set_gain, 
and Config_0 

Input, Sequent ial__s can, Random_scan, 
Calibrate, and Config_0 

Sequent ial__scan, Random_scan, and 
Calibrate "" 

Input, Random__scan, Sequent ial_scan, 
and Calibrate 

Random_scan, Sequent ial_scan, 
Set_gain, Set_units, and Calibrate 

Input, Sequent ial_scan, Random_scan, 
and Calibrate 

Input, Sequent ial_s can, Random_scan, 
and Calibrate 

Input (interrupt mode only), 
Sequent ial_s can, Random_scan, and 
Calibrate 

Set_units, Config_0 

Config_0 

Calibrate 
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Messages 



Pascal- related Messages 



BASIC 


Pascal 


Message 


Message 


Number 


Number 


400 





399 


-1 


398 


-2 


397 


-3 


396 


-4 


395 


-5 


394 


-6 


393 


-7 


392 


-8 


391 


-9 


390 


-10 


389 


-11 


388» 


-12 


387 


-13 


386 


-14 


385 


-15 


384 


-16 


383 


-17 


382 


-18 


381 


-19 


380 


-20 


379 


-21 


378 


-22 


377 


-23 


376 


-24 


375 


-25 


374 


-26 


373 


-27 



Meaning 

Normal termination 

Abnormal termination 

Not enough memory 

Reference to NIL pointer 

Integer overflow 

Divide by zero 

Real math overflow; number too large 

Real math underflow; number too small 

Value range error 

Case value range error 

Non-zero I/O result 

CPU word access to odd address 

CPU bus error 

Illegal CPU instruction 

CPU privilege violation 

Bad argument - SIN/COS 

Bad argument - Natural Log 

Bad argument - SQRT (square root) 

Bad argument - real/BCD conversion 

Bad argument - BCD/ real conversion 

Stopped by user 

Unas signed CPU trap 

Reserved 

Reserved 

Macro parameter not 0..9 or a..z 

Undefined macro parameter 

Error in I/O subsystem 

Graphics error 



* In a BASIC 2. lystem you may get this error if you try to initialize an ADC card for a select code that 
contains no card. 
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This appendix is a quick reference guide to the Measurement Library subroutine calls. We've squeezed 
the call summaries into small type so that they fit onto the next page; you can take that page out of this 
manual and hang it on your wall for quick reference. 

BASIC programmers please note that the parameters that you pass to the Measurement Library 
subroutines must be properly typed (integer, real, or string). If you don't know the type of a parameter, 
you can look it up in Section 2 of this manual. 
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CALIBRATE 



MEAS LIB INIT 



BASIC: Calibrate (name, channel, pace, number) 



BASIC: Meas_lib_init 



Pascal: PROCEDURE calibrate (name: str255; 

chart: shortint; 
pace: real; 
number: shortint); 

CONFIG_0 

BASIC : Conf ig_0 (name .model [ , selec t_code [ , gain [ , 
pace [,report_error[, units [, 
multiplier [.off set J]]) J]]) 

Pascal: PROCEDURE conf igj) (name: str255; 

model: str2SS; 
»elect_code: shortint; 
gain: shortint; 
pace: real; 
report_error: str2SS; 
units: str2S5; 
multiplier: real; 
offset: real); 

DISABLE__INTR 

BASIC: Oisable_intr(name) 

Pascal: PROCEDURE dis»ble_intr(name: str2SS); 



ENABLE.JNTR 

BASIC: Enable_intr(name) 

Pascal: PROCEDURE enable_int r (name: str25S); 



Pascal: PROCEDURE meas_lib_init ; 



RANDOM__SCAN 

BASIC: Random_scan(name,chan_array(*) ,data_array(*) (, 
rept[,pace_array(*)[, 
gain_array(»))]]) 

Pascal: PROCEDURE random_scan(name: str25S; 

chan_iize: integer; 
chan_arrey: anyptr; 
data_size: integer; 
date_«rrey: anyptr; 
rept : shortint; 
pace_size: Integer; 
pace.arrey: anyptr; 
gain_size: integer; 
gain_array: anyptr); 

SEQUENTIAL_SCAN 

BASIC : Sequent ial.scen ( name .start, stop, pace , 
data_array(«) Crept]) 

Pascal: PROCEDURE seqvential_scan(name: str255; 

start: shortint; 
stop: shortint; 
pace: real; 
data_size: integer; 
date__array: anyptr; 
rept: shortint); 

SET GAIN 



INIT 



BASIC: Set_gain(name,galn) 



BASIC: Init(name) 

Pascal: PROCEDURE init(name: str255); 

INPUT / READ_CHANNEL 

BASIC: Input (name, channel, datum [,gain(, pace))) 

Pascal: PROCEDURE read_channel(name: str2S5; 

channel: shortint; 
VAR datum: real; 
gain: shortint; 
pace: real); 



Pascal: PROCEDURE set_gein(name: str2S$; 

gain: shortint); 

SET_UNITS 

BASIC: Set_unit s (name, units [.multiplier [.offset]]) 

Pascal: PROCEDURE set_units(name: str2SS; 

units: str255; 
multiplier: real; 
offset: real); 

SYSTEM_JNIT 

BASIC: System_init 

Pascal. «fOCEDURE system.init; 
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ADC card 

calibration, 1-7 

configuration, 1-5, 1-8, 2-3 

configurations, multiple, 1-8, 1-20, 2-4, 2-7 

initialization, 1-5, 2-8, 2-17 

input pipeline, 1-14 

readings, 1-9 

sampling speed, 1-1, 1-19 
Analog input pipeline, 1-14, 1-20 



B 

Base units, 1-1, 1-7, 1-18,2-4,2-16 

BASIC. 



BASIC 

common area, 1-5 
error handling, 1-8 
extensions, 1-2 
heap area, 1-5 
interrupt mode, 1-19 



interrupt mode, 1-19 

loading the Measurement Library subroutines, 1-2, 1-; 
Measurement Library subroutine size, 1-3 
parameter typing, 1-3, 1-7, 2-5 

fimoMfnmin. 1-0 1.1 1 -4. 



programming, 1-2, 1-3, 1-4 



Calibrate subroutine, 1-7, 2-2 

Calibration, 1-1, 1-5, 1-7, 2-2 

Common area, 1-5 

Common mode overrange condition, 1-7, 1-8, 1-15, 1-16, 1-17, 1 - 1 8, 2-4 

Configuration of ADC cards, 1-5, 1-8, 2-3 

Config_0 subroutine, 1-5, 1-7, 1-8, 1-9, 1-10, 1-18, 1-20, 2-3 

Control lines, IPACDA and EPCON, 1-21 

CSUB package, 1-1 
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Disable intr subroutine, 1-19, 2-6 



Enable intr subroutine, 1 - 1 9, 2-7 

EPCON control line, 1-21 
Error handling, 1-8 
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Error messages, A- 1 
Error reporting, 1-8 
ERRN function, 1-8 
ESCAPECODE function, 1-8 
External pacing, 1-21 



G 

Gain, 1-5, 1-6,2-15 

H 

Heap area, 1-5 

HP 14751 A package, 1-1, 1-9, 2-1 



I 

Init subroutine, 1-5, 1-20, 2-8, 2-17 
Initializing 

ADC card, 1-5, 2-8, 2-17 

Measurement Library, 1-5, 2-10 
Input pipeline, 1-14, 1-20 
Input subroutine, 1-6, 1-9, 1-20, 2-7, 2-9 

Interrupt mode, 1-1, 1-2, 1-3, 1-4, 1-10, 1-15, 1-19, 2-4, 2-6, 2-7, 2-9 
DPACDA control line, 1-21 



Least significan bit (LSB) values, 2-5 

Loading the Measurement Library subroutines, 1-2, 1-3 

LSB values, 2-5 
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Measurement Library 

features, 1-1 

general information, 1 - 1 

initialization, 1-5, 2-10 

programming, 1-2 

quick reference, B- 1 

size, 1-3, 1-4 

software provided, 1-2 

subroutines, 1-2, 1-3 

Meas lib init subroutine, 1-5, 2-10 

Messages, A- 1 

Multiple configuration of an ADC card, 1-8, 1-20 

Multiple configurations of an ADC card, 2-4, 2-7 
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Normal mode overrange condition, 1-5, 1-8, 1-15, 1-16, 1-17, 1-18 



ON ERROR mechanism, 1 - 8 

Overrange condition 
common mode, 1-7, 1-8, 1-15, 1-16, 1-17, 1-18,2-4 
normal mode, 1-5, 1-8, 1-15, 1-16, 1-17, 1-18 



Pace interval, 1 -5, 1 -6, 1 - 1 9 
Pacing errors, 1-19 
Pacing, external, 1-21 
Pascal 

common area, 1-5 

error handling, 1-8 

heap area, 1-5 

importing the Measurement Library, 1-3 

interrupt mode, 1-4, 1-19, 2-7 

Measurement Library size, 1-4 

parameter passing, 1-4 

parameter typing, 1-4, 1-7, 2-1, 2-5 

programming, 1-3, 1-4 
Pipeline, 1-14, 1-20 
Programming 

general, 1-2, 1-4 

in BASIC, 1-2, 1-3, 1-4 

in Pascal, 1-3, 1-4 

Q 

Quick reference guide, B- 1 
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